跳轉到主要內容
本主題涵蓋下列內容:

解鎖成就

透過 Partner Center 設定成就並發佈至您的開發沙箱之後,您的遊戲就可以呼叫 XblAchievementsUpdateAchievementAsync API 來解鎖成就。 如需詳細資訊,請參閱下一節中的範例程式碼。 若要解鎖成就,請將 percentComplete 設為 100。 如果使用者在線上,要求會立即傳送至 XBOX 服務成就服務,並觸發下列使用者體驗。
  • 使用者會收到「成就已解鎖」通知。
  • 指定的成就會在使用者該遊戲的成就清單中顯示為已解鎖。
  • 已解鎖的成就會新增至使用者的活動摘要。
無論成就使用事件型成就或遊戲管理型成就,使用者體驗在視覺上都相同。
如果使用者離線,解鎖要求會在使用者的裝置上本機排入佇列。 裝置重新建立網路連線後,要求就會自動傳送至成就服務 (遊戲不需要採取任何動作來觸發此作業),並如前所述發生先前的使用者體驗。

更新成就的完成進度

若要更新使用者解鎖成就的進度,請呼叫 XblAchievementsUpdateAchievementAsync。將 percentComplete 引數設為 1 到 100 之間的整數。 如需詳細資訊,請參閱下列範例程式碼。 成就的進度只能增加。 如果 percentComplete 設定的數字小於成就上一次的 percentComplete 值,則會忽略此更新。 例如,如果成就的 percentComplete 先前已設為 75,則傳送值為 25 的更新會被忽略。該成就仍會顯示為完成 75%。 如果 percentComplete 設為 100,成就就會解鎖。 如果 percentComplete 設定的數字大於 100,API 的行為會如同您將數字設為剛好 100。

更新目前遊戲的成就

您可以呼叫 XblAchievementsUpdateAchievementAsync 來更新目前遊戲的成就,如下所示。 Flat C API
如需詳細資訊,請參閱下列內容:

更新其他遊戲的成就

您可以使用 XblAchievementsUpdateAchievementForTitleIdAsync 來更新另一個 titleId 的成就,如下所示。 Flat C API
如需詳細資訊,請參閱下列內容: 返回本主題頂端。
最後修改於 2026年10月8日