Skip to main content

XblUserProfile

表示用户的 XBOX Live 配置文件。

语法

成员

xboxUserId
类型:uint64_t
用户的 XBOX 用户 ID。 appDisplayName
类型:char[XBL_DISPLAY_NAME_CHAR_SIZE]
用于应用程序 UI 中的用户显示名称的 UTF-8 编码。它始终为用户的玩家代号,并且与 gameDisplayName 字段相同。 appDisplayPictureResizeUri
类型:char[XBL_DISPLAY_PIC_URL_RAW_CHAR_SIZE]
用户的玩家图片的 UTF-8 编码 Uri。它始终与 gameDisplayPictureResizeUri 字段相同。该 Uri 是可调整大小的 Uri。可以通过追加 ‘&format=&w=&h= 来指定以下大小和格式之一:
格式:png
宽度 高度
64 64
208 208
424 424
gameDisplayName
类型:char[XBL_DISPLAY_NAME_CHAR_SIZE]
用于应用程序 UI 中的用户显示名称的 UTF-8 编码。它始终为用户的玩家代号,并且与 appDisplayName 字段相同。 gameDisplayPictureResizeUri
类型:char[XBL_DISPLAY_PIC_URL_RAW_CHAR_SIZE]
用户的玩家图片的 UTF-8 编码 Uri。它始终与 appDisplayPictureResizeUri 字段相同。该 Uri 是可调整大小的 Uri。可以通过追加 ‘&format=&w=&h= 来指定以下大小和格式之一:
格式:png
宽度 高度
64 64
208 208
424 424
gamerscore
类型:char[XBL_GAMERSCORE_CHAR_SIZE]
用户 Gamerscore 的 UTF-8 编码。 gamertag
类型:char[XBL_GAMERTAG_CHAR_SIZE]
用户经典玩家代号的 UTF-8 编码。此字段仅使用 ASCII 字符,且不包含后缀。 modernGamertag
类型:char[XBL_MODERN_GAMERTAG_CHAR_SIZE]
用户新式玩家代号的 UTF-8 编码。此字段使用特定范围的 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
最后修改于 2026年8月24日