GET (/users/xuid()/scids//stats)
代表指定的使用者,取得以逗號分隔的使用者統計資料名稱清單為範圍的服務設定。 這些 URI 的網域為userstats.xboxlive.com。
備註
用戶端需要一種方式,代表玩家將遊戲統計資料讀取和寫入我們的新玩家統計資料系統。URI 參數
查詢字串參數
| 參數| 類型| 描述| | --- | --- | --- | --- | --- | --- | | statNames| string| 唯一的查詢字串參數是以逗號分隔的使用者統計資料名稱 URI 名詞。例如,下列 URI 會通知服務,代表 URI 中指定的使用者識別碼要求四項統計資料。https://userstats.xboxlive.com/users/xuid({xuid})/scids/{scid}/stats/wins,kills,kdratio,headshots單一呼叫中可要求的統計資料數目會有限制,而該限制會仔細考量開發人員便利性與 URI 長度實用性之間的「最佳平衡點」。例如,限制可能取決於 600 個字元的統計資料名稱文字 (包括逗號),或最多 10 項統計資料。啟用像這樣的簡單 GET,可以為經常要求的統計資料啟用 HTTP 快取,進而減少頻繁呼叫之用戶端的呼叫量。 |
授權
針對內容隔離和存取控制案例,已實作授權邏輯。- 只要呼叫端隨要求提交有效的 XSTS 權杖,任何平台上的用戶端都可以讀取排行榜和使用者統計資料。寫入作業顯然僅限於 Player Data 系統支援的用戶端。
- 遊戲開發人員可以使用 Partner Center 將統計資料標示為開放或受限制。排行榜是開放的統計資料。只要使用者已獲授權存取沙箱,Smartglass 以及 iOS、Android、Windows、Windows Phone 和 Web 應用程式就可以存取開放的統計資料。使用者對沙箱的授權是透過 Partner Center 管理。
