跳轉到主要內容

XblUserStatisticsGetSingleUserStatisticsAsync

取得單一使用者的指定統計資料。

語法

參數

xblContextHandle   _In_
類型:XblContextHandle
本機使用者的 XBOX Live 內容。 xboxUserId   _In_
類型:uint64_t
要取得統計資料之玩家的 XBOX 使用者識別碼。 serviceConfigurationId   _In_z_
類型:char*
遊戲的服務設定識別碼 (SCID)。SCID 會區分大小寫,因此請直接從 Partner Center 貼上。 statisticNames   _In_
類型:char**
要查閱的統計資料名稱集合。 statisticNamesCount   _In_
類型:size_t
統計資料名稱的數目。 async   _In_
類型:XAsyncBlock*
此作業的 AsyncBlock。

傳回值

類型:HRESULT 此 API 作業的 HRESULT 傳回碼。

備註

完成時呼叫 XblUserStatisticsGetSingleUserStatisticsResultSize 和 XblUserStatisticsGetSingleUserStatisticsResult 以取得結果。只會傳回具有值的統計資料。例如,如果您要求 3 個統計資料名稱,但只有 2 個具有值,服務只會傳回 2 個統計資料。 如果使用以事件為基礎的統計資料,統計資料名稱會與每個統計資料的統計資料執行個體一致。如果使用遊戲管理的統計資料,統計資料名稱會與每個統計資料的識別碼一致。 透過此 API 要求的統計資料會轉換成以逗號分隔的清單,其長度限制為 260 個字元。如果呼叫此方法時收到 400 錯誤,請嘗試要求較少的統計資料,以縮短此轉換後字串的長度。

REST 呼叫

V1 GET /users/xuid()/scids//stats/,…,

需求

標頭: user_statistics_c.h 程式庫: Microsoft.Xbox.Services.14x.GDK.C.lib

另請參閱

user_statistics_c
最後修改於 2026年10月6日