Skip to main content

​
Introduction

Game Saves permet aux utilisateurs de passer facilement d’un appareil à l’autre en maintenant leur progression disponible chaque fois qu’ils se connectent. Le système enregistre les données localement, puis les synchronise avec le cloud lorsque l’appareil se connecte à Internet. Une fois la synchronisation terminée, les utilisateurs peuvent accéder à leurs données enregistrées sur n’importe quel appareil pris en charge.

​
XBOX Play Anywhere et Game Saves

XBOX Play Anywhere utilise Game Saves pour permettre aux utilisateurs de partager leur progression de jeu en toute transparence entre les appareils Windows, les consoles XBOX, les PC et les appareils portables. XBOX Play Anywhere repose sur une synchronisation cohérente des données de sauvegarde. Les utilisateurs peuvent reprendre là où ils s’étaient arrêtés sur n’importe quel appareil pris en charge. Pour plus d’informations, consultez XBOX Play Anywhere.

​
Cycle de développement de Game Saves

L’article sur le cycle de développement de Game Saves vous propose un parcours structuré pour créer, valider et maintenir des systèmes de sauvegarde fiables connectés au cloud. Il vous guide dans l’intégration de Game Saves à un nouveau titre, puis dans le débogage, les tests, la certification et le support après publication. Chaque étape met en évidence les exigences, les outils et les bonnes pratiques nécessaires pour que votre titre enregistre les données de manière cohérente, les synchronise en toute sécurité et offre une expérience utilisateur transparente sur tous les appareils. Ce cycle de vie permet à votre implémentation de Game Saves de se comporter de manière prévisible, du premier prototype jusqu’à la publication et au-delà. L’article sur le cycle de vie décrit le flux de bout en bout lorsque vous planifiez, implémentez, validez, publiez et maintenez Game Saves. Ce cycle de vie est décrit comme suit.
  1. Prise en main de Game Saves : intégration initiale avec les concepts, les API, les modèles de stockage et les exigences de plateforme de Game Saves.
  2. Configuration d’un nouveau titre : intégrez Game Saves tôt dans le développement. Par exemple :
    • Ajoutez une initialisation dépendante de la connexion de l’utilisateur.
    • Configurez des identificateurs tels que l’identificateur de configuration de service (SCID) et l’ID d’application de compte Microsoft (MSA) (MSAAppID).
    • Définissez votre conception de stockage et votre structure de conteneurs.
  3. Débogage des problèmes pendant le développement : résolvez les premiers problèmes d’implémentation. Vous pouvez rencontrer les problèmes suivants :
    • Problèmes de configuration du SCID
    • Problèmes de durée de vie des handles
    • Problèmes de quota/mémoire
    • Interprétation des erreurs NTSTATUS
  4. Planification des tests : définissez des plans de test structurés. Par exemple, testez les domaines suivants :
    • Exactitude de la lecture/écriture des données
    • Comportement hors connexion
    • Logique de synchronisation
    • Flux des boîtes de dialogue système
    • Scénarios multi-appareils
  5. Scénarios de test : effectuez des tests fonctionnels et de charge détaillés. Par exemple, testez le comportement de votre titre dans les situations suivantes.
    • Changements de connectivité
    • États de conflit  - Changement d’utilisateur
    • Gestion des données endommagées
    • Cas limites de stockage
  6. Préparer votre titre pour la publication : finalisez votre configuration Game Saves avant de publier. Ce travail comprend généralement les tâches suivantes :
    • Valider votre configuration Microsoft Partner Center
    • Confirmer que votre titre utilise les quotas appropriés
    • Vérifier que les boîtes de dialogue système fonctionnent comme prévu
    • Vérifier que votre titre utilise des modèles d’écriture sécurisée
  7. Exigences de certification : respectez les exigences de certification XBOX. Cela comprend, par exemple :
    • Un comportement de synchronisation correct.
    • La gestion des changements de connectivité.
    • La conformité aux règles relatives aux données utilisateur et aux informations d’identification personnelle (PII).
  8. Gérer les problèmes après la publication : surveillez et résolvez les problèmes en production. Vous pouvez rencontrer des situations telles que :
    • Des échecs de synchronisation.
    • Des signalements de perte de données utilisateur.
    • Des problèmes de limite de stockage.
  9. Scénarios de migration : les scénarios comprennent les éléments suivants :
    • Mise à jour de la disposition du stockage
    • Passage d’une API Game Saves à une autre
    • Transition entre les versions d’un titre

​
Documentation de Game Saves

Cette documentation vous aide à comprendre et à implémenter l’ensemble de l’écosystème Game Saves. Elle explique le fonctionnement des API, la façon dont les modèles d’utilisateur et la gestion de la durée de vie des processus (PLM) façonnent votre flux de données de sauvegarde, et la manière dont les systèmes de stockage, les quotas et le comportement hors connexion influencent votre conception. Elle fournit également des conseils pour les tests et le débogage, décrit les boîtes de dialogue système que les utilisateurs peuvent rencontrer et présente les exigences de certification à respecter avant la publication.

​
Guide du développeur Game Saves

Cet article fournit une vue d’ensemble de l’écosystème Game Saves et des principales considérations pour les développeurs, telles que les API disponibles, les modèles d’utilisateur, la PLM, les recommandations en matière de sécurité et de PII, les exigences de certification et les détails sur les limites de stockage.

​
Comprendre le flux de synchronisation de Game Saves

Cet article explique l’atomicité au niveau du conteneur/dossier et un flux de synchronisation en six étapes, ainsi que le comportement en mode hors connexion et l’utilisation du fournisseur propre à la machine.

​
Systèmes de stockage de Game Saves

Cet article présente différents contextes de stockage. Il couvre le stockage de titre (cloud), le stockage local des sauvegardes et le stockage du fournisseur de machine, ainsi que les quotas par titre et les détails du stockage local propre à la console.

​
Boîtes de dialogue système de Game Saves

Cet article décrit les boîtes de dialogue système que les utilisateurs peuvent rencontrer lorsqu’ils effectuent des opérations Game Saves.

​
Procédures pas à pas et exemples Game Saves

Cet article explique comment configurer Partner Center et comment utiliser des modèles d’écriture sécurisée, comme l’écriture dans un fichier temporaire puis son remplacement atomique. Il décrit également comment gérer les scénarios hors connexion et hors réseau et comment utiliser les flux de boîtes de dialogue système. En outre, il explique comment gérer les données Game Saves sur les appareils utilisés, tester le comportement de synchronisation cloud et migrer entre titres ou API.

​
Débogage de Game Saves

Cet article explique les erreurs Game Save courantes et les étapes de résolution des problèmes, notamment les problèmes de SCID, les bonnes pratiques relatives à la durée de vie des handles, les limitations de quota et de mémoire, et la manière d’interpréter les codes Win32 NTSTATUS.

​
Outils Game Saves

Cet article explique comment utiliser Fiddler pour inspecter le trafic réseau de Game Saves. Il montre également comment utiliser les outils en ligne de commande xbstorage et gamesaveutil pour exporter ou importer des données de sauvegarde locales sur console et sur PC.

​
Vue d’ensemble de l’API XGameSaveFiles

Cet article décrit le flux d’initialisation de XGameSaveFilesGetFolderWithUIAsync, la sémantique de synchronisation cloud automatique Win32 recommandée, les conseils relatifs aux quotas et au débogage, les bonnes pratiques en matière de performances et les questions fréquentes.

​
Vue d’ensemble de l’API XGameSave

Cet article explique le modèle de stockage par conteneurs et blobs, comment initialiser et fermer les fournisseurs et comment les handles de mise à jour évoluent au cours de leur cycle de vie. Il couvre également le comportement des mises à jour atomiques, les diagrammes du flux de synchronisation, les limites de taille de fichier et de quota, les bonnes pratiques recommandées et les questions fréquentes.
Last modified on October 6, 2026