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() を使用します

​

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

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

​

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

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 で発火します。