実績の解除
実績が Partner Center で構成され、開発サンドボックスに公開された後、タイトルは XblAchievementsUpdateAchievementAsync API を呼び出すことでそれらを解除できます。 詳細は、次のセクションのサンプル コードを参照してください。 実績を解除するには、percentComplete を 100 に設定します。
ユーザーがオンラインの場合、リクエストはただちに XBOX services の Achievements サービスに送信され、次のユーザー体験がトリガーされます。
- ユーザーは実績解除通知を受け取ります。
- 指定された実績は、タイトルのユーザーの実績リストで解除済みとして表示されます。
- 解除された実績はユーザーのアクティビティ フィードに追加されます。
ユーザー体験は、イベント ベースの実績を使用する実績と、タイトル マネージド実績を使用する実績の両方で、視覚的には同じです。
実績の達成進捗の更新
実績の解除に向けたユーザーの進捗を更新するには、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
