> ## 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](/zh-TW/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](/zh-TW/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](/zh-TW/services/playfab/api-references/c/pftypes/structs/pflinkedplatformaccountmodel) const\*\
*may be nullptr*

（選擇性）連結到此玩家帳戶的所有驗證系統清單。

**`linkedAccountsCount`**   uint32\_t

linkedAccounts 的計數

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

（選擇性）玩家登入遊戲時所在的地理位置清單。

**`locationsCount`**   uint32\_t

locations 的計數

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

（選擇性）玩家的成員資格清單，以及其是否已到期。

**`membershipsCount`**   uint32\_t

memberships 的計數

**`origination`**   [PFLoginIdentityProvider](/zh-TW/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](/zh-TW/services/playfab/api-references/c/pftypes/structs/pfpushnotificationregistrationmodel) const\*\
*may be nullptr*

（選擇性）已註冊用於傳送玩家推播通知的已設定端點清單。

**`pushNotificationRegistrationsCount`**   uint32\_t

pushNotificationRegistrations 的計數

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

（選擇性）玩家的排行榜統計值清單。

**`statisticsCount`**   uint32\_t

statistics 的計數

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

（選擇性）用於分群的玩家標籤清單。

**`tagsCount`**   uint32\_t

tags 的計數

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

（選擇性）此玩家設定檔所套用的遊戲識別碼。

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

（選擇性）玩家以真實貨幣購買的總和，換算為等值美元，並以整數美分 (1/100 USD) 表示。例如，999 表示九美元九十九美分。

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

（選擇性）玩家終身購買總額清單，依真實貨幣加總。

**`valuesToDateCount`**   uint32\_t

valuesToDate 的計數

## 需求

**標頭:** PFTypes.h

## 另請參閱

[PFTypes 成員](/zh-TW/services/playfab/api-references/c/pftypes/pftypes_members)


## Related topics

- [PFAccountManagementGetPlayerProfileResult](/zh-TW/services/playfab/api-references/c/pfaccountmanagementtypes/structs/pfaccountmanagementgetplayerprofileresult.md)
- [服務 C API 概觀 - PFTypes.h](/zh-TW/services/playfab/api-references/c/pftypes/pftypes_members.md)
- [PFGetPlayerCombinedInfoResultPayload](/zh-TW/services/playfab/api-references/c/pftypes/structs/pfgetplayercombinedinforesultpayload.md)
- [PFFriendsFriendInfo](/zh-TW/services/playfab/api-references/c/pffriendstypes/structs/pffriendsfriendinfo.md)
- [教學課程：取得玩家設定檔](/zh-TW/services/playfab/player-progression/player-data/getting-player-profiles.md)