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

​

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.