Reversión de Game Saves

La reversión le permite restaurar el guardado de juego de un jugador a un estado anterior. Úsela cuando el guardado de un jugador se dañe, cuando una actualización del título introduzca un error que dañe los datos de guardado o cuando un jugador quiera revertir una decisión de resolución de conflictos.

Cómo funciona la reversión

Game Saves realiza el seguimiento de las versiones finalizadas de los datos de guardado de un jugador. Cuando desencadena una reversión, el servicio crea una nueva versión cuyo contenido es idéntico al estado anterior que está restaurando. La reversión conserva el historial de versiones original. No elimina ni sobrescribe versiones anteriores. Los demás dispositivos que se sincronizan después de la reversión la ven como una actualización normal. Hay dos tipos de reversión. Cada uno se desencadena pasando una marca de opción a PFGameSaveFilesAddUserWithUiAsync:

Opción	Descripción
`PFGameSaveFilesAddUserOptions::RollbackToLastKnownGood`	Restaura el guardado en la nube anterior verificado más recientemente. Este guardado se cargó previamente y luego fue reemplazado por una carga más reciente.
`PFGameSaveFilesAddUserOptions::RollbackToLastConflict`	Restaura el estado de guardado que perdió la resolución de conflictos más reciente.

Ambas opciones recurren al comportamiento predeterminado (sincronizar la versión más reciente actual) si no existe ningún punto de restauración apto.

Cuándo usar cada tipo de reversión

Reversión al último estado correcto conocido

Use RollbackToLastKnownGood cuando sospeche que la carga más reciente es incorrecta. Los desencadenantes habituales incluyen:

Error de carga o comprobación de integridad fallida después de descargar un guardado.
Un bloqueo durante una operación de guardado o inmediatamente después.
Un informe de un jugador sobre un estado dañado o con retroceso.

El servicio realiza automáticamente el seguimiento de qué versiones son “correctas conocidas”. No es necesario marcarlas explícitamente. Una versión pasa a ser correcta conocida cuando la carga correctamente y una carga más reciente la reemplaza posteriormente.

Reversión al último conflicto

Use RollbackToLastConflict cuando un jugador eligió el lado equivocado durante la resolución de conflictos. Como se describe en Conflictos de Game Saves, ambas opciones de resolución conservan la rama descartada. Esta opción de reversión restaura esa rama conservada.

Llamada a la API

Desencadene la reversión pasando la opción adecuada a PFGameSaveFilesAddUserWithUiAsync. Solo puede llamar a esta función una vez por usuario, por lo que para revertir en el caso de un usuario que ya se ha agregado, primero llame a PFGameSaveFilesUninitializeAsync y espere a que se complete.

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

Para revertir en su lugar al perdedor del último conflicto, reemplace la marca de opción:

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

Comportamiento de reserva

Si no existe ningún punto de restauración apto para el tipo de reversión solicitado, la llamada se comporta como si hubiera pasado PFGameSaveFilesAddUserOptions::None. La versión más reciente actual se sincroniza con normalidad. Compruebe los archivos sincronizados después de que se complete la llamada para confirmar si se produjo una reversión.

Configuración del título

Puede restringir la reversión iniciada por el cliente mediante dos marcas de configuración. Cuando habilita cualquiera de las marcas, solo las herramientas de soporte técnico y Game Manager pueden realizar ese tipo de reversión.

Marca	Efecto
`DisableClientRollbackToLastKnownGood`	Impide que los clientes del juego reviertan a la última versión correcta conocida.
`DisableClientRollbackToLastConflictLoser`	Impide que los clientes del juego reviertan la decisión de resolución de conflictos más reciente.

Establezca estas marcas en Game Manager en Progression > Game Saves.

Control de errores

HRESULT	Significado
`E_PF_GAME_SAVE_MANIFEST_NOT_ELIGIBLE_FOR_ROLLBACK`	No existe ningún punto de restauración apto para el tipo de reversión solicitado.
`E_PF_GAME_SAVE_NOT_FINALIZED_MANIFEST_NOT_ELIGIBLE_AS_KNOWN_GOOD`	La versión de destino no es apta como punto de restauración correcto conocido.
`E_PF_GAME_SAVE_SERVICE_NOT_ENABLED_FOR_TITLE`	Game Saves no está habilitado para este título. Complete primero la incorporación.
`E_PF_GAME_SAVE_SERVICE_ONBOARDING_PENDING`	La incorporación del título aún está en curso.

Consideraciones

La reversión crea una nueva versión. No borra el historial. La secuencia de versiones del jugador continúa hacia adelante.
El servicio realiza el seguimiento del estado correcto conocido automáticamente. Determina qué versiones son aptas en función de ciclos correctos de carga y posterior reemplazo. Su juego no necesita marcar las versiones explícitamente.
Una reversión por llamada de adición de usuario. Dado que solo puede llamar a PFGameSaveFilesAddUserWithUiAsync una vez por usuario, desencadenar una segunda reversión requiere llamar primero a PFGameSaveFilesUninitializeAsync.
Las devoluciones de llamada de la interfaz de usuario se siguen activando. La reversión pasa por el mismo flujo de sincronización que una llamada de adición de usuario normal. Registre sus devoluciones de llamada de la interfaz de usuario antes de llamar a la API.
Restrinja la reversión si es necesario. Si su juego controla la recuperación en el lado del servidor o mediante herramientas de soporte técnico, deshabilite la reversión del cliente con las marcas de configuración del título para evitar que los jugadores reviertan el progreso accidentalmente.
La reversión funciona en todas las plataformas. Esta API no tiene protecciones específicas de plataforma.

XBOX Services

PlayFab

Cómo funciona la reversión

Cuándo usar cada tipo de reversión

Reversión al último estado correcto conocido

Reversión al último conflicto

Llamada a la API

Comportamiento de reserva

Configuración del título

Control de errores

Consideraciones

​Cómo funciona la reversión

​Cuándo usar cada tipo de reversión

​Reversión al último estado correcto conocido

​Reversión al último conflicto

​Llamada a la API

​Comportamiento de reserva

​Configuración del título

​Control de errores

​Consideraciones

Cómo funciona la reversión

Cuándo usar cada tipo de reversión

Reversión al último estado correcto conocido

Reversión al último conflicto

Llamada a la API

Comportamiento de reserva

Configuración del título

Control de errores

Consideraciones