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