Game Saves ロールバック

​

ロールバックの仕組み

​

各ロールバックタイプの使用時機

​

last known good へのロールバック

• セーブのダウンロード後のロード失敗または整合性チェック失敗。
• セーブ操作中または直後のクラッシュ。
• 状態が破損または退行したというプレイヤー報告。

​

last conflict へのロールバック

​

API の呼び出し

// Rollback to last known good version
XAsyncBlock async{};
async.queue = queue;
async.callback = [](XAsyncBlock* async)
{
    HRESULT hr = PFGameSaveFilesAddUserWithUiResult(async);
    if (SUCCEEDED(hr))
    {
        // Save data is now restored to the last known good version.
        // Read files from the game save folder as usual.
    }
};

HRESULT hr = PFGameSaveFilesAddUserWithUiAsync(
    localUserHandle,
    PFGameSaveFilesAddUserOptions::RollbackToLastKnownGood,
    &async
);

HRESULT hr = PFGameSaveFilesAddUserWithUiAsync(
    localUserHandle,
    PFGameSaveFilesAddUserOptions::RollbackToLastConflict,
    &async
);

​

フォールバック動作

​

タイトル構成

​

エラー処理

​

考慮事項

• ロールバックは新しいバージョンを作成します。 履歴は消去しません。プレイヤーのバージョンシーケンスは前に進み続けます。
• サービスは known good を自動的に追跡します。 正常なロードと後続の置換のサイクルに基づいて、どのバージョンが該当するかを決定します。ゲーム側で明示的にバージョンをマークする必要はありません。
• add-user 呼び出しごとに 1 回のロールバック。 PFGameSaveFilesAddUserWithUiAsync はユーザーごとに 1 回しか呼び出せないため、2 回目のロールバックをトリガーするには、まず PFGameSaveFilesUninitializeAsync を呼び出す必要があります。
• UI コールバックも発火します。 ロールバックは通常の add-user 呼び出しと同じ同期フローを通過します。API を呼び出す前に UI コールバック を登録してください。
• 必要に応じてロールバックを制限してください。 ゲームがサーバーサイドまたはサポートツールを通じて復旧を処理する場合は、タイトル構成フラグを使用してクライアントロールバックを無効にし、プレイヤーが誤って進行状況を戻すのを防ぎます。
• ロールバックはすべてのプラットフォームで動作します。 この API にはプラットフォーム固有のガードはありません。