获取单个用户的指定统计信息。
语法
HRESULT XblUserStatisticsGetSingleUserStatisticsAsync(
XblContextHandle xblContextHandle,
uint64_t xboxUserId,
const char* serviceConfigurationId,
const char** statisticNames,
size_t statisticNamesCount,
XAsyncBlock* async
)
参数
xblContextHandle _In_
类型:XblContextHandle
本地用户的 Xbox Live 上下文。
xboxUserId _In_
类型:uint64_t
要获取其统计信息的玩家的 Xbox 用户 ID。
serviceConfigurationId _In_z_
类型:char*
游戏的服务配置 ID (SCID)。 因为将 SCID 视为区分大小写,所以可直接从合作伙伴中心粘贴它。
statisticNames _In_
类型:char**
要查找的统计信息名称的集合。
statisticNamesCount _In_
类型:size_t
统计信息名称的数量。
async _In_
类型:XAsyncBlock*
此操作的 AsyncBlock。
返回值
类型:HRESULT
此 API 操作的 HRESULT 返回代码。
备注
完成后调用 XblUserStatisticsGetSingleUserStatisticsResultSize 和 XblUserStatisticsGetSingleUserStatisticsResult 以获取结果。 仅返回包含值的统计信息。 例如,如果要求 3 个统计信息名称,而只有 2 个包含值,则服务仅返回 2 个统计信息。
如果使用基于事件的统计信息,统计信息名称将与每个统计信息的统计信息实例一致。 如果使用游戏管理的统计信息,统计信息名称将与每个统计信息的 ID 一致。
通过此 API 请求的统计信息将转换为具有 260 个字符限制的逗号分隔列表。 如果在调用此方法时收到 400 错误,请尝试请求较少的统计信息以缩短此转换后字符串的长度。
REST 调用
V1 GET /users/xuid({xuid})/scids/{scid}/stats/{statname1},...,{statnameN}
要求
头文件:user_statistics_c.h
图书馆: Microsoft.Xbox.Services.14x.GDK.C.lib