Game Saves の UI コールバック

​

状態マシンの動作

• 各コールバックタイプには対応する応答 API があります。応答 API を呼び出して、システムに次に何をすべきかを伝えます。
• 応答 API は、コールバック関数の内側または外側から呼び出すことができます。
• 応答アクションが Retry の場合、操作は再試行され、同じコールバックが再度発生する可能性があります。
• XAsyncBlock コールバックは、操作が終端状態 (成功、キャンセル、またはオフラインフォールバック) に達したときにのみ発生します。

1. エラーとともに PFGameSaveFilesUiSyncFailedCallback が発生します。
2. XAsyncBlock コールバックはまだ発生しません。状態マシンは応答を待機します。
3. ユーザーが Retry を選択して再試行も失敗した場合、同期失敗コールバックが再度発生します。
4. ユーザーが Cancel を選択すると、XAsyncBlock コールバックが E_PF_GAMESAVE_USER_CANCELLED で発生します。
5. 再試行が成功すると、XAsyncBlock コールバックが S_OK で発生します。

​

コールバックがトリガーされるタイミング

​

コールバックの登録

PFGameSaveUICallbacks callbacks{};
callbacks.progressCallback = MyProgressCallback;
callbacks.progressContext = nullptr;
callbacks.syncFailedCallback = MySyncFailedCallback;
callbacks.syncFailedContext = nullptr;
callbacks.activeDeviceContentionCallback = MyActiveDeviceContentionCallback;
callbacks.activeDeviceContentionContext = nullptr;
callbacks.conflictCallback = MyConflictCallback;
callbacks.conflictContext = nullptr;
callbacks.outOfStorageCallback = MyOutOfStorageCallback;
callbacks.outOfStorageContext = nullptr;

HRESULT hr = PFGameSaveFilesSetUiCallbacks(&callbacks);

​

コールバックリファレンス

​

進行状況

​

同期状態

​

同期失敗

​

アクティブデバイスの競合

​

競合

​

ストレージ不足

​

インプロセスとアウトオブプロセス (システム UI)

• アウトオブプロセス (XBOX および Windows): XBOX および Windows では、Game Saves は常にアウトオブプロセスで実行されます。プラットフォーム (Connected Storage / GRTS) が同期を実行し、同期失敗、競合、アクティブデバイスの競合、ストレージ不足に対する組み込みのシステム UI ダイアログを提供します。プレイヤーはこれらのダイアログを直接操作し、プラットフォームはその結果を、ゲームがインプロセスで受け取るのと同じ非同期完了コードに変換します。組み込みの UI を置き換えるためにコールバックを登録することもできます。
• インプロセス (Steam Deck などのその他のプラットフォーム): プラットフォーム サービスが利用できない場合、ゲームが Game Saves 同期エンジンをホストし、上記のコールバックを通じて UI イベントを処理します。ゲームは応答 API を使用して状態マシンを完全に制御します。

​

キャンセルは常に起こり得る結果です

​

プラットフォーム要件

​

関連コンテンツ

• Game Saves クイックスタート
• Game Saves オフラインモード
• Game Saves の競合
• Game Saves のアクティブデバイスの変更