Mode hors connexion de Game Saves

​

Modes de connexion

​

Mode connecté au nuage

• Toutes les API fonctionnent normalement avec une synchronisation infonuagique complète
• Les téléversements des données de sauvegarde fonctionnent comme prévu
• Les informations sur le quota de stockage sont disponibles
• La surveillance de l’appareil actif fonctionne correctement

​

Mode hors connexion (non connecté au nuage)

​

Gestion des défaillances réseau pendant la synchronisation initiale

// 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) : retente l’appel réseau. Si la nouvelle tentative échoue également, ce rappel se déclenche de nouveau et l’utilisateur doit répondre de nouveau. Le rappel XAsyncBlock reste différé à chaque boucle de nouvelle tentative.
• Use Offline (UseOffline) : le rappel XAsyncBlock se déclenche avec S_OK, mais le système passe en mode hors connexion (détectable avec PFGameSaveFilesIsConnectedToCloud()).
• Cancel : le rappel XAsyncBlock se déclenche avec E_PF_GAMESAVE_USER_CANCELLED.

​

Comportement des API en mode hors connexion

​

API qui fonctionnent normalement

• PFGameSaveFilesGetFolder() - Retourne le chemin du dossier de sauvegarde local

​

API aux fonctionnalités limitées

• PFGameSaveFilesUploadWithUiAsync() - Retourne S_OK immédiatement, mais la fin de l’opération asynchrone retourne E_PF_GAMESAVE_DISCONNECTED_FROM_CLOUD
• PFGameSaveFilesGetRemainingQuota() - Retourne E_PF_GAMESAVE_DISCONNECTED_FROM_CLOUD
• PFGameSaveFilesSetActiveDeviceChangedCallback() - Peut être défini, mais ne se déclenchera jamais

​

Retour au mode en ligne

• Appelez de nouveau PFGameSaveFilesAddUserWithUiAsync() pour tenter une reconnexion
• Il n’est pas nécessaire de réinitialiser complètement le système Game Saves
• L’interface utilisateur d’échec s’affichera de nouveau si le réseau n’est toujours pas disponible
• Utilisez PFGameSaveFilesIsConnectedToCloud() pour vérifier l’état de la connexion après les nouvelles tentatives

​

Quand Game Saves passe en mode hors connexion ou retourne une erreur

• Le mode hors connexion est un résultat réussi, et non une erreur. On n’y accède que par un choix explicite de Use Offline, et l’opération asynchrone se termine avec S_OK. Détectez-le avec PFGameSaveFilesIsConnectedToCloud().
• Les défaillances temporaires ou techniques sont signalées par l’interface utilisateur d’échec de synchronisation, et ne sont pas retournées directement par PFGameSaveFilesAddUserWithUiAsync. L’utilisateur (ou votre réponse automatique) choisit alors Retry, UseOffline ou Cancel, ce qui aboutit à l’un des trois résultats ci-dessus.
• L’annulation est finale et ne produit aucun dossier de sauvegarde. Traitez « annulé » (ou tout échec qui ne laisse aucun dossier) comme ne pas permettre de jouer.
• L’annulation par le joueur et l’annulation par le jeu retournent des codes différents. Seul le choix de Cancel par le joueur dans une invite produit E_PF_GAMESAVE_USER_CANCELLED. Si votre jeu annule lui-même l’opération avec XAsyncCancel, celle-ci se termine avec E_ABORT. Vérifiez les deux si vous souhaitez les traiter de la même manière.

​

Codes d’erreur de Game Saves

​

Autres scénarios d’état de connexion

• Réseau indisponible pendant la synchronisation : l’utilisateur choisit explicitement de jouer hors connexion
• Changement d’appareil actif : un autre appareil devient l’appareil actif, ce qui fait automatiquement passer cet appareil en mode hors connexion

​

Pratiques exemplaires pour la prise en charge hors connexion

1. Implémentez toujours les rappels d’échec de synchronisation pour gérer les problèmes réseau de façon appropriée
2. Vérifiez régulièrement l’état de la connexion à l’aide de PFGameSaveFilesIsConnectedToCloud() avant de tenter des opérations infonuagiques
3. Informez les joueurs lorsque le jeu fonctionne en mode hors connexion afin qu’ils comprennent que les sauvegardes ne seront pas synchronisées
4. Offrez des options de nouvelle tentative lorsque la connectivité réseau est rétablie
5. Les sauvegardes locales fonctionnent toujours - les joueurs peuvent continuer à jouer quel que soit l’état du réseau
6. Surveillez les déconnexions - n’oubliez pas que des appareils peuvent être déconnectés lorsqu’un autre appareil devient actif

​

Comportement des téléversements en mode connecté

1. Le PFGameSaveFilesUiSyncFailedCallback se déclenche avec les détails de l’erreur.
2. Le rappel XAsyncBlock ne se déclenche pas encore. L’opération est suspendue pendant que le système attend une réponse.
3. Si l’utilisateur sélectionne Retry, le téléversement est retenté. S’il échoue de nouveau, le rappel se déclenche de nouveau et l’utilisateur doit répondre de nouveau.
4. Si l’utilisateur sélectionne Cancel, le rappel XAsyncBlock se déclenche avec E_PF_GAMESAVE_USER_CANCELLED.
5. Si une nouvelle tentative réussit, le rappel XAsyncBlock se déclenche avec S_OK.

​

Lorsqu’un téléversement met la session hors connexion

• La session était déjà hors connexion. Le téléversement ne s’exécute pas et se termine avec E_PF_GAMESAVE_DISCONNECTED_FROM_CLOUD, même si le réseau a été rétabli.
• Le nuage contient une sauvegarde plus récente. Si le service signale, lors de la finalisation du téléversement, qu’une sauvegarde plus récente a été validée à partir d’un autre appareil, Game Saves met la session hors connexion, déclenche le rappel de changement d’appareil actif et termine le téléversement avec E_PF_GAMESAVE_DISCONNECTED_FROM_CLOUD.
• Le joueur choisit Use Offline dans l’invite de reverrouillage. Si un téléversement antérieur a validé ses données, mais a échoué par la suite, le téléversement suivant doit d’abord réacquérir le verrou de sauvegarde. Une invite d’échec de synchronisation pendant cette étape peut recevoir la réponse UseOffline, ce qui met la session hors connexion et termine le téléversement avec E_PF_GAMESAVE_DISCONNECTED_FROM_CLOUD.

​

Annulation d’un téléversement