跳轉到主要內容

XblSocialManagerUser

包含個人檔案、狀態、慣用色彩及遊戲歷程記錄資料的 XBOX 社交使用者。

語法

成員

xboxUserId
類型:uint64_t
Xbox 使用者識別碼。 isFavorite
類型:bool
是否為最愛。 isFriend
類型:bool
指出某位使用者與另一位使用者之間是否存在相互的追蹤者/追蹤中關係 isFollowingUser
類型:bool
不再表示呼叫使用者是否正在追蹤指定的使用者。保留此欄位是為了回溯相容性。此欄位的值由 ‘isFriend’ 的值決定 isFollowedByCaller
類型:bool
不再表示呼叫使用者是否受指定使用者追蹤。保留此欄位是為了回溯相容性。此欄位的值由 ‘isFriend’ 的值決定 displayName
類型:char[XBL_DISPLAY_NAME_CHAR_SIZE]
以 UTF-8 編碼的顯示名稱。XblSocialManager 執行的許多批次作業不會傳回玩家的 displayName。請改用 gamerTag 或 modernGamerTag realName
類型:char[XBL_REAL_NAME_CHAR_SIZE]
以 UTF-8 編碼的真實姓名。 displayPicUrlRaw
類型:char[XBL_DISPLAY_PIC_URL_RAW_CHAR_SIZE]
以 UTF-8 編碼的顯示圖片 URI。 useAvatar
類型:bool
是否使用玩家的虛擬人偶。 gamerscore
類型:char[XBL_GAMERSCORE_CHAR_SIZE]
以 UTF-8 編碼的玩家玩家分數。 gamertag
類型:char[XBL_GAMERTAG_CHAR_SIZE]
以 UTF-8 編碼的玩家玩家代號。 modernGamertag
類型:char[XBL_MODERN_GAMERTAG_CHAR_SIZE]
玩家的新式玩家代號。不保證是唯一的。 modernGamertagSuffix
類型:char[XBL_MODERN_GAMERTAG_SUFFIX_CHAR_SIZE]
附加至新式玩家代號以確保唯一性的尾碼。在某些情況下可能是空的。 uniqueModernGamertag
類型:char[XBL_UNIQUE_MODERN_GAMERTAG_CHAR_SIZE]
結合新式玩家代號與尾碼。格式為 “MGT#suffix”。保證轉譯後不超過 16 個字元。 presenceRecord
類型:XblSocialManagerPresenceRecord
使用者的狀態記錄。 titleHistory
類型:XblTitleHistory
使用者的遊戲歷程記錄。 preferredColor
類型:XblPreferredColor
使用者的慣用色彩。

隸屬於

XblSocialManagerEvent

需求

標頭: social_manager_c.h

另請參閱

social_manager_c
最後修改於 2026年10月6日