XblUserStatisticsGetSingleUserStatisticsAsync

获取单个用户的指定统计信息。

语法

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 返回代码。

备注

完成后调用 XblUserStatisticsGetSingleUserStatisticsResultSizeXblUserStatisticsGetSingleUserStatisticsResult 以获取结果。 仅返回包含值的统计信息。 例如,如果要求 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

另请参阅

user_statistics_c