> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PFPlayerProfileModel

> PFPlayerProfileModel 数据模型。

PFPlayerProfileModel 数据模型。

## 语法

```cpp theme={null}
typedef struct PFPlayerProfileModel {  
    PFAdCampaignAttributionModel const* adCampaignAttributions;  
    uint32_t adCampaignAttributionsCount;  
    const char* avatarUrl;  
    time_t const* bannedUntil;  
    PFContactEmailInfoModel const* contactEmailAddresses;  
    uint32_t contactEmailAddressesCount;  
    time_t const* created;  
    const char* displayName;  
    const char* const* experimentVariants;  
    uint32_t experimentVariantsCount;  
    time_t const* lastLogin;  
    PFLinkedPlatformAccountModel const* linkedAccounts;  
    uint32_t linkedAccountsCount;  
    PFLocationModel const* locations;  
    uint32_t locationsCount;  
    PFMembershipModel const* memberships;  
    uint32_t membershipsCount;  
    PFLoginIdentityProvider const* origination;  
    const char* playerId;  
    const char* publisherId;  
    PFPushNotificationRegistrationModel const* pushNotificationRegistrations;  
    uint32_t pushNotificationRegistrationsCount;  
    PFStatisticModel const* statistics;  
    uint32_t statisticsCount;  
    PFTagModel const* tags;  
    uint32_t tagsCount;  
    const char* titleId;  
    uint32_t const* totalValueToDateInUSD;  
    PFValueToDateModel const* valuesToDate;  
    uint32_t valuesToDateCount;  
} PFPlayerProfileModel;  
```

### 成员

**`adCampaignAttributions`**   [PFAdCampaignAttributionModel](/services/playfab/api-references/c/pftypes/structs/pfadcampaignattributionmodel) const\*\
*may be nullptr*

（可选）玩家被归因的广告活动列表。

**`adCampaignAttributionsCount`**   uint32\_t

adCampaignAttributions 的数量

**`avatarUrl`**   const char\*\
*is null-terminated*

（可选）玩家头像图像的 URL。

**`bannedUntil`**   time\_t const\*\
*may be nullptr*

（可选）如果玩家当前被禁用，则为禁用到期时的 UTC 日期。

**`contactEmailAddresses`**   [PFContactEmailInfoModel](/services/playfab/api-references/c/pftypes/structs/pfcontactemailinfomodel) const\*\
*may be nullptr*

（可选）与该玩家账号相关联的所有联系电子邮件信息的列表。

**`contactEmailAddressesCount`**   uint32\_t

contactEmailAddresses 的数量

**`created`**   time\_t const\*\
*may be nullptr*

（可选）玩家记录的创建时间。

**`displayName`**   const char\*\
*is null-terminated*

（可选）玩家显示名称。

**`experimentVariants`**   const char\* const\*\
*may be nullptr*

（可选）玩家的实验变体列表。请注意，登录期间返回的这些变体不能保证为最新，因为玩家个人资料仅在登录后才更新。相反，请在登录期间使用 LoginResult.TreatmentAssignment 属性来获取正确的变体和变量。

**`experimentVariantsCount`**   uint32\_t

experimentVariants 的数量

**`lastLogin`**   time\_t const\*\
*may be nullptr*

（可选）玩家最近登录到游戏的 UTC 时间。

**`linkedAccounts`**   [PFLinkedPlatformAccountModel](/services/playfab/api-references/c/pftypes/structs/pflinkedplatformaccountmodel) const\*\
*may be nullptr*

（可选）链接到此玩家账号的所有身份验证系统的列表。

**`linkedAccountsCount`**   uint32\_t

linkedAccounts 的数量

**`locations`**   [PFLocationModel](/services/playfab/api-references/c/pftypes/structs/pflocationmodel) const\*\
*may be nullptr*

（可选）玩家已登录到游戏的地理位置列表。

**`locationsCount`**   uint32\_t

locations 的数量

**`memberships`**   [PFMembershipModel](/services/playfab/api-references/c/pftypes/structs/pfmembershipmodel) const\*\
*may be nullptr*

（可选）玩家的会员资格列表，以及是否已过期。

**`membershipsCount`**   uint32\_t

memberships 的数量

**`origination`**   [PFLoginIdentityProvider](/services/playfab/api-references/c/pftypes/enums/pfloginidentityprovider) const\*\
*may be nullptr*

（可选）玩家账号的来源。

**`playerId`**   const char\*\
*is null-terminated*

（可选）PlayFab 玩家账号唯一标识符。

**`publisherId`**   const char\*\
*is null-terminated*

（可选）此玩家所属的发布者。

**`pushNotificationRegistrations`**   [PFPushNotificationRegistrationModel](/services/playfab/api-references/c/pftypes/structs/pfpushnotificationregistrationmodel) const\*\
*may be nullptr*

（可选）已注册以发送玩家推送通知的已配置终结点列表。

**`pushNotificationRegistrationsCount`**   uint32\_t

pushNotificationRegistrations 的数量

**`statistics`**   [PFStatisticModel](/services/playfab/api-references/c/pftypes/structs/pfstatisticmodel) const\*\
*may be nullptr*

（可选）玩家的排行榜统计值列表。

**`statisticsCount`**   uint32\_t

statistics 的数量

**`tags`**   [PFTagModel](/services/playfab/api-references/c/pftypes/structs/pftagmodel) const\*\
*may be nullptr*

（可选）用于细分的玩家标签列表。

**`tagsCount`**   uint32\_t

tags 的数量

**`titleId`**   const char\*\
*is null-terminated*

（可选）此玩家个人资料所适用的游戏 ID。

**`totalValueToDateInUSD`**   uint32\_t const\*\
*may be nullptr*

（可选）玩家使用真实货币进行的购买总额，转换为等值的美元并表示为整数美分（1/100 美元）。例如，999 表示九美元九十九美分。

**`valuesToDate`**   [PFValueToDateModel](/services/playfab/api-references/c/pftypes/structs/pfvaluetodatemodel) const\*\
*may be nullptr*

（可选）玩家的终身购买总额列表，按真实货币汇总。

**`valuesToDateCount`**   uint32\_t

valuesToDate 的数量

## 要求

**头文件：** PFTypes.h

## 另请参阅

[PFTypes 成员](/services/playfab/api-references/c/pftypes/pftypes_members)


## Related topics

- [PFAccountManagementGetPlayerProfileResult](/zh-CN/services/playfab/api-references/c/pfaccountmanagementtypes/structs/pfaccountmanagementgetplayerprofileresult.md)
- [服务 C API 概览 - PFTypes.h](/zh-CN/services/playfab/api-references/c/pftypes/pftypes_members.md)
- [PFGetPlayerCombinedInfoResultPayload](/zh-CN/services/playfab/api-references/c/pftypes/structs/pfgetplayercombinedinforesultpayload.md)
- [PFFriendsFriendInfo](/zh-CN/services/playfab/api-references/c/pffriendstypes/structs/pffriendsfriendinfo.md)
- [PlayerProfile](/zh-CN/services/playfab/api-references/events/data-types/playerprofile.md)