跳轉到主要內容

XblAchievementsUpdateAchievementForTitleIdAsync

允許更新成就進度及解除鎖定成就。

語法

參數

xboxLiveContext   _In_
類型:XblContextHandle
使用 XblContextCreateHandle 建立的 Xbox Live 內容控制代碼。 xboxUserId   _In_
類型:uint64_t
玩家的 XBOX 使用者識別碼。 titleId   _In_
類型:uint32_t
遊戲識別碼。 serviceConfigurationId   _In_z_
類型:char*
遊戲的服務設定識別碼 (SCID)。SCID 區分大小寫,因此請直接從 Partner Center 貼上。 achievementId   _In_z_
類型:char*
由 XDP 或開發人員中心定義之成就的 UTF-8 編碼識別碼。 percentComplete   _In_
類型:uint32_t
表示進度的成就完成百分比。有效值為 1 到 100。設定為 100 即可解除鎖定成就。伺服器會將進度設定為所傳送的最高值。 async   _In_
類型:XAsyncBlock*
呼叫端配置的 AsyncBlock。

傳回值

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

備註

即使在 PC 和 XBOX One 上離線時,此 API 也能運作。重新建立連線時,即使遊戲未在執行中,系統也會發佈離線更新。在 AsyncBlock 回呼內或在 AsyncBlock 完成後呼叫 XAsyncGetStatus,即可取得非同步作業的結果。如果此作業意外失敗,請確認 XblInitArgs 中的 SCID 正確無誤,因為 SCID 區分大小寫。

REST 呼叫

V2 POST /users/xuid()/achievements//update

需求

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

另請參閱

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