跳轉到主要內容

XblUserProfile

表示使用者的 XBOX Live 設定檔。

語法

成員

xboxUserId
類型:uint64_t
使用者的 XBOX 使用者識別碼。 appDisplayName
類型:char[XBL_DISPLAY_NAME_CHAR_SIZE]
要在應用程式 UI 中使用的 UTF-8 編碼使用者顯示名稱。這一律是使用者的玩家代號,且與 gameDisplayName 欄位相同。 appDisplayPictureResizeUri
類型:char[XBL_DISPLAY_PIC_URL_RAW_CHAR_SIZE]
使用者玩家圖片的 UTF-8 編碼 Uri。這一律與 gameDisplayPictureResizeUri 欄位相同。此 Uri 是可調整大小的 Uri。您可以附加 ‘&format=&w=&h=,以指定下列其中一種大小和格式:
格式:png
寬度 高度
64 64
208 208
424 424
gameDisplayName
類型:char[XBL_DISPLAY_NAME_CHAR_SIZE]
要在應用程式 UI 中使用的 UTF-8 編碼使用者顯示名稱。這一律是使用者的玩家代號,且與 appDisplayName 欄位相同。 gameDisplayPictureResizeUri
類型:char[XBL_DISPLAY_PIC_URL_RAW_CHAR_SIZE]
使用者玩家圖片的 UTF-8 編碼 Uri。這一律與 appDisplayPictureResizeUri 欄位相同。此 Uri 是可調整大小的 Uri。您可以附加 ‘&format=&w=&h=,以指定下列其中一種大小和格式:
格式:png
寬度 高度
64 64
208 208
424 424
gamerscore
類型:char[XBL_GAMERSCORE_CHAR_SIZE]
使用者的 UTF-8 編碼玩家分數。 gamertag
類型:char[XBL_GAMERTAG_CHAR_SIZE]
使用者的 UTF-8 編碼傳統玩家代號。此欄位僅使用 ASCII 字元,且不包含尾碼。 modernGamertag
類型:char[XBL_MODERN_GAMERTAG_CHAR_SIZE]
使用者的 UTF-8 編碼新式玩家代號。此欄位使用特定範圍的 UTF-8 字元,且不包含尾碼。不保證是唯一的。 modernGamertagSuffix
類型:char[XBL_MODERN_GAMERTAG_SUFFIX_CHAR_SIZE]
附加至新式玩家代號以確保唯一性的 UTF-8 編碼數字尾碼。在某些情況下可能是空的。 uniqueModernGamertag
類型:char[XBL_UNIQUE_MODERN_GAMERTAG_CHAR_SIZE]
UTF-8 編碼的唯一新式玩家代號及數字尾碼。格式為 “modernGamertag#suffix”。保證轉譯後不超過 16 個字元。

作為下列項目的引數

XblProfileGetUserProfileResult
XblProfileGetUserProfilesResult
XblProfileGetUserProfilesForSocialGroupResult

需求

標頭: profile_c.h

另請參閱

profile_c
最後修改於 2026年10月19日