GET (/users/xuid()/scids//stats?include=valuemetadata)
获取指定服务配置中某用户的指定统计信息列表,包括与统计信息值相关联的元数据。 这些 URI 的域为userstats.xboxlive.com。
备注
?include=valuemetadata 查询参数允许响应包含与用户统计信息值相关联的任何元数据,例如用于在赛道上达到某一时间的汽车的型号和颜色。 要在响应中包含值元数据,请求调用还必须将标头值 X-Xbl-Contract-Version 设置为 3。URI 参数
查询字符串参数
| 参数 | 类型 | 说明 | | --- | --- | --- | --- | --- | --- | | statNames | string | 以逗号分隔的用户统计信息名称列表。例如,以下 URI 通知服务:代表 URI 中指定的用户 ID 请求四项统计信息。{::nomakrdown}https://userstats.xboxlive.com/users/xuid({xuid})/scids/{scid}/stats/wins,kills,kdratio,headshots?include=valuemetadata |
| include=valuemetadata | string | 指示响应包含与用户统计信息值相关联的任何值元数据。 |
授权
为内容隔离和访问控制场景实现了授权逻辑。- 排行榜和用户统计信息都可以由任何平台上的客户端读取,前提是调用方在请求中提交有效的 XSTS 令牌。写入仅限于 Player Data 系统支持的客户端。
- 标题开发者可以在 Partner Center 将统计信息标记为开放或受限。排行榜是开放统计信息。只要用户已获得对沙盒的授权,开放统计信息就可以由 Smartglass 以及 iOS、Android、Windows、Windows Phone 和 Web 应用程序访问。用户对沙盒的授权通过 Partner Center 管理。
