> ## 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 用户 ID。

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

用户在线状态记录。

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

用户的标题历史记录。

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

用户的首选颜色。

## 成员属于

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

## 要求

**标头：** social\_manager\_c.h

## 另请参阅

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


## Related topics

- [XblSocialManagerUserGroupGetUsers](/zh-CN/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerusergroupgetusers.md)
- [Social Manager 概述](/zh-CN/services/xbox-services/community/social-manager/live-social-manager-overview.md)
- [XblSocialManagerPresenceRecord](/zh-CN/reference/live/xsapi-c/social_manager_c/structs/xblsocialmanagerpresencerecord.md)
- [XblSocialManagerEvent](/zh-CN/reference/live/xsapi-c/social_manager_c/structs/xblsocialmanagerevent.md)
- [XblPreferredColor](/zh-CN/reference/live/xsapi-c/social_manager_c/structs/xblpreferredcolor.md)