GET (/users/xuid()/scids//stats)
指定されたユーザーに代わって、コンマ区切りのユーザー統計名リストによってスコープが指定されたサービス構成を取得します。 これらの URI のドメインはuserstats.xboxlive.com です。
解説
クライアントは、新しいプレイヤー統計システムにおいて、プレイヤーに代わってタイトルの統計情報を読み書きする方法を必要とします。URI パラメーター
クエリ文字列パラメーター
| パラメーター | 型 | 説明 | | --- | --- | --- | --- | --- | --- | | statNames | string | 唯一のクエリ文字列パラメーターは、コンマ区切りのユーザー統計名 URI 名詞です。たとえば、次の URI は、URI で指定されたユーザー ID の代わりに 4 つの統計を要求していることをサービスに通知します。https://userstats.xboxlive.com/users/xuid({xuid})/scids/{scid}/stats/wins,kills,kdratio,headshots 1 回の呼び出しで要求できる統計の数には制限があり、その制限は開発者の利便性と URI 長の実用性の “スイート スポット” を慎重に考慮しています。たとえば、制限は 600 文字分の統計名テキスト (コンマを含む) または最大 10 個の統計によって決定されることがあります。このような単純な GET を有効にすると、よく要求される統計に対して HTTP キャッシュが有効になり、頻繁に呼び出すクライアントからの呼び出し量を削減できます。 |
認可
コンテンツの分離とアクセス制御のシナリオを実装する認可ロジックがあります。- リーダーボードとユーザー統計はいずれも、呼び出し元が要求と共に有効な XSTS トークンを送信していれば、任意のプラットフォームのクライアントから読み取ることができます。書き込みは、当然、Player Data システムがサポートしているクライアントに限られます。
- タイトル開発者はパートナー センターを使用して、統計を open または restricted としてマークできます。リーダーボードは open 統計です。open 統計は、ユーザーがサンドボックスに対して認可されている限り、Smartglass、iOS、Android、Windows、Windows Phone、および Web アプリケーションからアクセスできます。サンドボックスに対するユーザーの認可は、パートナー センターを通じて管理されます。