解鎖成就
透過 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
