Modo sin conexión de Game Saves

​

Modos de conexión

​

Modo conectado a la nube

• Todas las API funcionan normalmente con sincronización completa en la nube
• Las cargas de datos de guardado funcionan según lo esperado
• La información de cuota de almacenamiento está disponible
• La supervisión del dispositivo activo funciona correctamente

​

Modo sin conexión (no conectado a la nube)

​

Control de errores de red durante la sincronización inicial

// 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
}

• Reintentar (Retry): Reintenta la llamada de red. Si el reintento también falla, esta devolución de llamada se activa de nuevo y el usuario debe responder otra vez. La devolución de llamada de XAsyncBlock permanece diferida durante cada bucle de reintento.
• Usar sin conexión (UseOffline): La devolución de llamada de XAsyncBlock se activa con S_OK, pero el sistema entra en modo sin conexión (detectable con PFGameSaveFilesIsConnectedToCloud()).
• Cancelar: La devolución de llamada de XAsyncBlock se activa con E_PF_GAMESAVE_USER_CANCELLED.

​

Comportamiento de las API en modo sin conexión

​

API que funcionan normalmente

• PFGameSaveFilesGetFolder(): devuelve la ruta de la carpeta de guardado local

​

API con funcionalidad limitada

• PFGameSaveFilesUploadWithUiAsync(): devuelve S_OK inmediatamente, pero la finalización asincrónica devuelve E_PF_GAMESAVE_DISCONNECTED_FROM_CLOUD
• PFGameSaveFilesGetRemainingQuota(): devuelve E_PF_GAMESAVE_DISCONNECTED_FROM_CLOUD
• PFGameSaveFilesSetActiveDeviceChangedCallback(): se puede establecer, pero nunca se desencadenará

​

Volver al modo en línea

• Llame de nuevo a PFGameSaveFilesAddUserWithUiAsync() para intentar la reconexión
• No es necesario reinicializar completamente el sistema de Game Saves
• Volverá a mostrar la interfaz de usuario de error si la red sigue sin estar disponible
• Use PFGameSaveFilesIsConnectedToCloud() para comprobar el estado de la conexión después de los intentos de reintento

​

Cuándo Game Saves entra en modo sin conexión o devuelve un error

• El modo sin conexión es un resultado correcto, no un error. Solo se entra en él mediante una elección explícita de Use Offline, y la operación asincrónica se completa con S_OK. Detéctelo con PFGameSaveFilesIsConnectedToCloud().
• Los errores transitorios o técnicos se muestran a través de la interfaz de usuario de error de sincronización, no se devuelven directamente desde PFGameSaveFilesAddUserWithUiAsync. A continuación, el usuario (o su respuesta automática) elige Retry, UseOffline o Cancel, lo que se resuelve en uno de los tres resultados anteriores.
• La cancelación es definitiva y no produce ninguna carpeta de guardado. Trate “cancelado” (o cualquier error que no deje ninguna carpeta) como no permitir jugar.
• La cancelación del jugador y la del juego devuelven códigos diferentes. Solo la elección de Cancel por parte del jugador en un mensaje produce E_PF_GAMESAVE_USER_CANCELLED. Si su juego cancela la operación por sí mismo con XAsyncCancel, se completa con E_ABORT. Compruebe ambos si desea tratarlos de la misma manera.

​

Códigos de error de Game Saves

​

Escenarios adicionales de estado de conexión

• Red no disponible durante la sincronización: El usuario elige explícitamente jugar sin conexión
• Cambio de dispositivo activo: Otro dispositivo toma el control como dispositivo activo, lo que pone automáticamente este dispositivo en modo sin conexión

​

Procedimientos recomendados para la compatibilidad sin conexión

1. Implemente siempre las devoluciones de llamada de error de sincronización para controlar correctamente los problemas de red
2. Compruebe el estado de la conexión con regularidad mediante PFGameSaveFilesIsConnectedToCloud() antes de intentar operaciones en la nube
3. Informe a los jugadores cuando funcionen en modo sin conexión para que entiendan que los guardados no se sincronizarán
4. Proporcione opciones de reintento cuando se restaure la conectividad de red
5. Los guardados locales siempre funcionan: los jugadores pueden seguir jugando independientemente del estado de la red
6. Supervise las desconexiones: recuerde que los dispositivos pueden desconectarse cuando otro dispositivo se convierte en el activo

​

Comportamiento de la carga en modo conectado

1. La PFGameSaveFilesUiSyncFailedCallback se activa con los detalles del error.
2. La devolución de llamada de XAsyncBlock aún no se activa. La operación se pausa mientras el sistema espera una respuesta.
3. Si el usuario selecciona Retry, la carga se reintenta. Si vuelve a fallar, la devolución de llamada se activa de nuevo y el usuario debe responder otra vez.
4. Si el usuario selecciona Cancel, la devolución de llamada de XAsyncBlock se activa con E_PF_GAMESAVE_USER_CANCELLED.
5. Si un reintento se realiza correctamente, la devolución de llamada de XAsyncBlock se activa con S_OK.

​

Cuándo una carga deja la sesión sin conexión

• La sesión ya estaba sin conexión. La carga no se ejecuta y se completa con E_PF_GAMESAVE_DISCONNECTED_FROM_CLOUD, aunque se haya restaurado la red.
• La nube tiene un guardado más reciente. Si el servicio informa de que se confirmó un guardado más reciente desde otro dispositivo cuando finaliza la carga, Game Saves pone la sesión sin conexión, activa la devolución de llamada de cambio de dispositivo activo y completa la carga con E_PF_GAMESAVE_DISCONNECTED_FROM_CLOUD.
• El jugador elige Use Offline en el mensaje de rebloqueo. Si una carga anterior confirmó sus datos pero falló después, la siguiente carga primero tiene que volver a adquirir el bloqueo de guardado. Un mensaje de error de sincronización durante ese paso se puede responder con UseOffline, lo que deja la sesión sin conexión y completa la carga con E_PF_GAMESAVE_DISCONNECTED_FROM_CLOUD.

​

Cancelación de una carga