XblUserProfile

表示用户的 Xbox Live 档案。

语法

typedef struct XblUserProfile {  
    uint64_t xboxUserId;  
    char appDisplayName[XBL_DISPLAY_NAME_CHAR_SIZE];  
    char appDisplayPictureResizeUri[XBL_DISPLAY_PIC_URL_RAW_CHAR_SIZE];  
    char gameDisplayName[XBL_DISPLAY_NAME_CHAR_SIZE];  
    char gameDisplayPictureResizeUri[XBL_DISPLAY_PIC_URL_RAW_CHAR_SIZE];  
    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];  
} XblUserProfile  

成员

xboxUserId
类型:uint64_t

用户的 Xbox 用户 ID。

appDisplayName
类型:char[XBL_DISPLAY_NAME_CHAR_SIZE]

要在应用程序 UI 中使用的 UTF-8 编码用户显示名称。 此值受隐私保护,可以是用户的实际姓名或其玩家代号。

appDisplayPictureResizeUri
类型:char[XBL_DISPLAY_PIC_URL_RAW_CHAR_SIZE]

要在应用程序 UI 中使用的用户显示图片的 UTF-8 编码 Uri。 该 Uri 是一个可调整大小的 Uri。 它可用于通过追加“&format={format}&w={width}&h={height}来指定以下大小和格式之一:
格式:png
宽度 高度
64 64
208 208
424 424

gameDisplayName
类型:char[XBL_DISPLAY_NAME_CHAR_SIZE]

要在游戏 UI 中使用的 UTF-8 编码用户显示名称。 此值受隐私保护,可以是用户的实际姓名或其玩家代号。

gameDisplayPictureResizeUri
类型:char[XBL_DISPLAY_PIC_URL_RAW_CHAR_SIZE]

要在游戏中使用的用户显示图片的 UTF-8 编码 Uri。 该 Uri 是一个可调整大小的 Uri。 它可用于通过追加“&format={format}&w={width}&h={height}来指定以下大小和格式之一:
格式:png
宽度 高度
64 64
208 208
424 424

gamerscore
类型:char[XBL_GAMERSCORE_CHAR_SIZE]

UTF-8 编码的用户的玩家分数。

gamertag
类型:char[XBL_GAMERTAG_CHAR_SIZE]

UTF-8 编码的用户的玩家代号。

modernGamertag
类型:char[XBL_MODERN_GAMERTAG_CHAR_SIZE]

用户的 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