Game Saves のオフライン モード

​

接続モード

​

クラウド接続モード

• すべての API がクラウド同期を完全に伴って正常に機能します
• セーブ データのアップロードは期待どおりに動作します
• ストレージ クォータの情報が利用可能です
• アクティブ デバイスの監視が正しく機能します

​

オフライン モード (クラウドに未接続)

​

初期同期中のネットワーク障害の処理

// Handle sync failure callback
void MyPFGameSaveFilesUiSyncFailedCallback(PFLocalUserHandle localUserHandle, PFGameSaveFilesSyncState syncState, HRESULT error, void* context)
{
    // Tell the user something like this:
    std::cout << "We couldn't sync your data with the cloud just now" << std::endl;
    std::cout << "Try syncing again or use this game offline" << std::endl;
    std::cout << "[Try Again]" << std::endl;
    std::cout << "[Use Offline]" << std::endl;

    // if user chooses [Try Again], call PFGameSaveFilesSetUiSyncFailedResponse(localUserHandle, PFGameSaveFilesUiSyncFailedUserAction::Retry);
    // if user chooses [Use Offline], call PFGameSaveFilesSetUiSyncFailedResponse(localUserHandle, PFGameSaveFilesUiSyncFailedUserAction::UseOffline);

    // These API calls can happen inside or outside of this callback
}

• Try Again (Retry): ネットワーク呼び出しを再試行します。再試行も失敗した場合、このコールバックが再度発火し、ユーザーが再度応答する必要があります。XAsyncBlock コールバックは、各再試行ループを通じて延期されたままです。
• Use Offline (UseOffline): XAsyncBlock コールバックが S_OK で発火しますが、システムはオフライン モードに入ります (PFGameSaveFilesIsConnectedToCloud() で検出できます)。
• Cancel: XAsyncBlock コールバックが E_PF_GAMESAVE_USER_CANCELLED で発火します。

​

オフライン モードでの API 動作

​

通常に動作する API

• PFGameSaveFilesGetFolder() - ローカル セーブ フォルダー パスを返します

​

機能が制限される API

• PFGameSaveFilesUploadWithUiAsync() - すぐに S_OK を返しますが、非同期の完了は E_PF_GAMESAVE_DISCONNECTED_FROM_CLOUD を返します
• PFGameSaveFilesGetRemainingQuota() - E_PF_GAMESAVE_DISCONNECTED_FROM_CLOUD を返します
• PFGameSaveFilesSetActiveDeviceChangedCallback() - 設定できますがトリガーされることはありません

​

オンライン モードに戻る

• 再接続を試みるために PFGameSaveFilesAddUserWithUiAsync() を再度呼び出します
• Game Saves システムを完全に再初期化する必要はありません
• ネットワークがまだ利用できない場合、再度失敗 UI が表示されます
• 再試行後に接続状態を検証するには PFGameSaveFilesIsConnectedToCloud() を使用します

​

Game Saves がオフライン モードに入る場合とエラーを返す場合

• オフライン モードはエラーではなく、成功の結果です。 オフライン モードには明示的に Use Offline を選択した場合にのみ入り、非同期操作は S_OK で完了します。PFGameSaveFilesIsConnectedToCloud() で検出してください。
• 一時的/技術的な障害は同期失敗 UI を通じて通知され、PFGameSaveFilesAddUserWithUiAsync から直接返されることはありません。その後、ユーザー (または自動応答) が Retry、UseOffline、または Cancel を選択し、上記の 3 つの結果のいずれかに解決されます。
• キャンセルは終端であり、セーブ フォルダーは生成されません。 「キャンセル」(またはフォルダーが残らない失敗) は プレイを許可しない として扱ってください。
• プレイヤーによるキャンセルとゲームによるキャンセルは異なるコードを返します。 E_PF_GAMESAVE_USER_CANCELLED が生成されるのは、プレイヤーがプロンプトで Cancel を選択した場合のみです。ゲーム自体が XAsyncCancel で操作をキャンセルした場合は、E_ABORT で完了します。両者を同じように扱いたい場合は、両方をチェックしてください。

​

Game Saves のエラー コード

​

その他の接続状態シナリオ

• 同期中のネットワーク利用不可: ユーザーが明示的にオフラインでのプレイを選択する
• アクティブ デバイスが変更された: 別のデバイスがアクティブ デバイスとして引き継ぎ、このデバイスは自動的にオフライン モードになる

​

オフライン サポートのベスト プラクティス

1. ネットワークの問題を適切に処理するために 常に同期失敗コールバックを実装 する
2. クラウド操作を試みる前に PFGameSaveFilesIsConnectedToCloud() を使用して 定期的に接続状態を確認 する
3. セーブが同期されないことをプレイヤーが理解できるように、オフライン モードで動作しているときに プレイヤーに通知 する
4. ネットワーク接続が復元されたときに 再試行オプションを提供 する
5. ローカル セーブは常に機能する - プレイヤーはネットワーク状態に関係なくプレイを続けることができる
6. 切断を監視する - 別のデバイスがアクティブになるとデバイスが切断される可能性があることを覚えておく

​

接続モードでのアップロード動作

1. エラーの詳細と共に PFGameSaveFilesUiSyncFailedCallback が発火します。
2. XAsyncBlock コールバックはまだ発火しません。システムが応答を待つ間、操作が一時停止されます。
3. ユーザーが Retry を選択すると、アップロードが再試行されます。再度失敗すると、コールバックが再度発火し、ユーザーが再度応答する必要があります。
4. ユーザーが Cancel を選択すると、XAsyncBlock コールバックが E_PF_GAMESAVE_USER_CANCELLED で発火します。
5. 再試行が成功すると、XAsyncBlock コールバックが S_OK で発火します。

​

アップロードによってセッションがオフラインになる場合

• セッションが既にオフラインだった。 ネットワークが復元されていても、アップロードは実行されず、E_PF_GAMESAVE_DISCONNECTED_FROM_CLOUD で完了します。
• クラウドに新しいセーブがある。 アップロードの最終処理時に、別のデバイスから新しいセーブがコミットされたことをサービスが報告した場合、Game Saves はセッションをオフラインにし、アクティブ デバイス変更コールバックを発火して、アップロードを E_PF_GAMESAVE_DISCONNECTED_FROM_CLOUD で完了します。
• プレイヤーが再ロックのプロンプトで Use Offline を選択した。 以前のアップロードがデータをコミットした後に失敗した場合、次のアップロードではまずセーブのロックを再取得する必要があります。このステップ中の同期失敗のプロンプトに UseOffline で応答すると、セッションがオフラインになり、アップロードは E_PF_GAMESAVE_DISCONNECTED_FROM_CLOUD で完了します。

​

アップロードのキャンセル