Skip to main content
このトピックでは、次の内容について説明します。

実績の解除

実績が Partner Center で構成され、開発サンドボックスに公開された後、タイトルは XblAchievementsUpdateAchievementAsync API を呼び出すことでそれらを解除できます。 詳細は、次のセクションのサンプル コードを参照してください。 実績を解除するには、percentComplete を 100 に設定します。 ユーザーがオンラインの場合、リクエストはただちに XBOX services の Achievements サービスに送信され、次のユーザー体験がトリガーされます。
  • ユーザーは実績解除通知を受け取ります。
  • 指定された実績は、タイトルのユーザーの実績リストで解除済みとして表示されます。
  • 解除された実績はユーザーのアクティビティ フィードに追加されます。
ユーザー体験は、イベント ベースの実績を使用する実績と、タイトル マネージド実績を使用する実績の両方で、視覚的には同じです。
ユーザーがオフラインの場合、解除リクエストはユーザーのデバイスにローカルにキューイングされます。 ネットワーク接続が再確立されると、リクエストは自動的に 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
詳細については、以下を参照してください。 このトピックの先頭に戻る。
最終更新日 2026年8月25日