Mode hors connexion de Game Saves

​

Modes de connexion

​

Mode connecté au cloud

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

​

Mode hors connexion (non connecté au cloud)

​

Gestion des défaillances réseau lors de 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 à 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() : renvoie le chemin du dossier de sauvegarde local

​

API aux fonctionnalités limitées

• PFGameSaveFilesUploadWithUiAsync() : renvoie immédiatement S_OK, mais l’achèvement asynchrone renvoie E_PF_GAMESAVE_DISCONNECTED_FROM_CLOUD
• PFGameSaveFilesGetRemainingQuota() : renvoie 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 de vous reconnecter
• Il n’est pas nécessaire de réinitialiser complètement le système Game Saves
• L’interface utilisateur d’échec s’affichera à 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 renvoie une erreur

• Le mode hors connexion est un résultat de réussite, et non une erreur. Il n’est activé 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/techniques sont signalées via l’interface utilisateur d’échec de synchronisation, et ne sont pas renvoyées directement par PFGameSaveFilesAddUserWithUiAsync. L’utilisateur (ou votre réponse automatique) choisit ensuite 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 toute défaillance qui ne laisse aucun dossier) comme ne pas autoriser le jeu.
• L’annulation par le joueur et l’annulation par le jeu renvoient 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, elle 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

​

Bonnes pratiques pour la prise en charge du mode hors connexion

1. Implémentez toujours des rappels d’échec de synchronisation pour gérer correctement les problèmes réseau
2. Vérifiez régulièrement l’état de la connexion à l’aide de PFGameSaveFilesIsConnectedToCloud() avant de tenter des opérations cloud
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. Proposez 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 chargements 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 chargement est retenté. S’il échoue à 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.

​

Quand un chargement met la session hors connexion

• La session était déjà hors connexion. Le chargement 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 cloud contient une sauvegarde plus récente. Si le service signale, lors de la finalisation du chargement, qu’une sauvegarde plus récente a été validée depuis un autre appareil, Game Saves met la session hors connexion, déclenche le rappel de changement d’appareil actif et termine le chargement avec E_PF_GAMESAVE_DISCONNECTED_FROM_CLOUD.
• Le joueur choisit Use Offline dans l’invite de reverrouillage. Si un chargement précédent a validé ses données mais a échoué ensuite, le chargement suivant doit d’abord réacquérir le verrou de sauvegarde. Une invite d’échec de synchronisation survenant pendant cette étape peut recevoir la réponse UseOffline, ce qui met la session hors connexion et termine le chargement avec E_PF_GAMESAVE_DISCONNECTED_FROM_CLOUD.

​

Annulation d’un chargement