> ## 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.

# XblSocialManagerUser

> XblSocialManagerUser

# XblSocialManagerUser

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

## 語法

```cpp theme={null}
typedef struct XblSocialManagerUser {  
    uint64_t xboxUserId;  
    bool isFavorite;  
    bool isFriend;  
    bool isFollowingUser;  
    bool isFollowedByCaller;  
    char displayName[XBL_DISPLAY_NAME_CHAR_SIZE];  
    char realName[XBL_REAL_NAME_CHAR_SIZE];  
    char displayPicUrlRaw[XBL_DISPLAY_PIC_URL_RAW_CHAR_SIZE];  
    bool useAvatar;  
    char gamerscore[XBL_GAMERSCORE_CHAR_SIZE];  
    char gamertag[XBL_GAMERTAG_CHAR_SIZE];  
    char modernGamertag[XBL_MODERN_GAMERTAG_CHAR_SIZE];  
    char modernGamertagSuffix[XBL_MODERN_GAMERTAG_SUFFIX_CHAR_SIZE];  
    char uniqueModernGamertag[XBL_UNIQUE_MODERN_GAMERTAG_CHAR_SIZE];  
    XblSocialManagerPresenceRecord presenceRecord;  
    XblTitleHistory titleHistory;  
    XblPreferredColor preferredColor;  
} XblSocialManagerUser  
```

### 成員

*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](/zh-TW/reference/live/xsapi-c/social_manager_c/structs/xblsocialmanagerpresencerecord)

使用者的狀態記錄。

*titleHistory*\
類型：[XblTitleHistory](/zh-TW/reference/live/xsapi-c/social_manager_c/structs/xbltitlehistory)

使用者的遊戲歷程記錄。

*preferredColor*\
類型：[XblPreferredColor](/zh-TW/reference/live/xsapi-c/social_manager_c/structs/xblpreferredcolor)

使用者的慣用色彩。

## 隸屬於

[XblSocialManagerEvent](/zh-TW/reference/live/xsapi-c/social_manager_c/structs/xblsocialmanagerevent)

## 需求

**標頭：** social\_manager\_c.h

## 另請參閱

[social\_manager\_c](/zh-TW/reference/live/xsapi-c/social_manager_c/social_manager_c_members)


## Related topics

- [XblSocialManagerUserGroupGetUsers](/zh-TW/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerusergroupgetusers.md)
- [XblSocialManagerPresenceRecord](/zh-TW/reference/live/xsapi-c/social_manager_c/structs/xblsocialmanagerpresencerecord.md)
- [XblSocialManagerEvent](/zh-TW/reference/live/xsapi-c/social_manager_c/structs/xblsocialmanagerevent.md)
- [XblTitleHistory](/zh-TW/reference/live/xsapi-c/social_manager_c/structs/xbltitlehistory.md)
- [XblPreferredColor](/zh-TW/reference/live/xsapi-c/social_manager_c/structs/xblpreferredcolor.md)