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);

​

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

​

進行状況

​

同期状態

​

同期失敗

​

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

​

競合

​

ストレージ不足

​

プラットフォーム要件

​

関連コンテンツ

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