Skip to main content

​
Introduction

Game Saves permet aux utilisateurs de passer d’un appareil à l’autre en toute fluidité en gardant leur progression accessible chaque fois qu’ils se connectent. Le système sauvegarde les données localement, puis les synchronise avec le nuage lorsque l’appareil se connecte à Internet. Une fois la synchronisation terminée, les utilisateurs peuvent accéder à leurs données sauvegardé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 fluidité 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 vie du développement de Game Saves

L’article sur le cycle de vie du développement de Game Saves vous offre un parcours structuré pour créer, valider et maintenir des systèmes de sauvegarde fiables connectés au nuage. Il vous guide dans l’intégration de Game Saves à un nouveau titre, puis dans le débogage, les tests, la certification et le soutien après la publication. Chaque étape met en évidence les exigences, les outils et les pratiques exemplaires dont vous avez besoin pour vous assurer que votre titre sauvegarde les données de façon cohérente, les synchronise de façon sécuritaire et offre une expérience utilisateur fluide sur tous les appareils. Ce cycle de vie aide votre implémentation de Game Saves à se comporter de façon 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. Bien démarrer avec Game Saves : intégration initiale des concepts, des API, des modèles de stockage et des 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 comme l’identificateur de configuration de service (SCID) et l’ID d’application du compte Microsoft (MSA) (MSAAppID).
    • Établissez la conception de votre stockage et la structure de vos conteneurs.
  3. Débogage des problèmes pendant le développement : résolvez les problèmes d’implémentation précoces. Vous pourriez rencontrer les problèmes suivants :
    • Problèmes de configuration du SCID
    • Problèmes de durée de vie des handles
    • Problèmes de quota ou de mémoire
    • Interprétation des erreurs NTSTATUS
  4. Planification des tests : définissez des plans de test structurés. Par exemple, testez les aspects suivants :
    • Exactitude de la lecture et de l’écriture des données
    • Comportement hors ligne
    • Logique de synchronisation
    • Flux des boîtes de dialogue système
    • Scénarios sur plusieurs appareils
  5. Scénarios de test : effectuez des tests fonctionnels et des tests 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 de la corruption
    • Cas limites de stockage
  6. Préparation de votre titre pour la publication : finalisez la configuration de Game Saves avant de publier. Ce travail comprend généralement les tâches suivantes :
    • Valider votre configuration de Microsoft Partner Center
    • Confirmer que votre titre utilise les bons quotas
    • S’assurer que les boîtes de dialogue système fonctionnent comme prévu
    • Vérifier que votre titre utilise des modèles d’écriture sécuritaires
  7. Exigences de certification : respectez les exigences de certification XBOX. Cela comprend, par exemple :
    • Un comportement de synchronisation approprié.
    • La gestion des changements de connectivité.
    • Le respect des règles relatives aux données utilisateur et aux informations d’identification personnelle (PII).
  8. Gestion des problèmes après la publication : surveillez et résolvez les problèmes en production. Vous pourriez rencontrer des situations comme :
    • Des échecs de synchronisation.
    • Des signalements de perte de données par les utilisateurs.
    • 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 des versions du titre

​
Ensemble de documentation de Game Saves

Cet ensemble de documentation vous aide à comprendre et à implémenter l’écosystème Game Saves complet. Il 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 façon dont les systèmes de stockage, les quotas et le comportement hors ligne influencent votre conception. Il 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 que vous devez respecter avant la publication.

​
Guide du développeur de Game Saves

Cet article fournit une vue d’ensemble de l’écosystème Game Saves et des principales considérations pour les développeurs, comme les API disponibles, les modèles d’utilisateur, la PLM, les conseils 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 ou du dossier et un flux de synchronisation en six étapes, ainsi que le comportement en mode hors ligne et l’utilisation du fournisseur propre à la machine.

​
Systèmes de stockage de Game Saves

Cet article présente divers contextes de stockage. Il couvre le stockage du titre (nuage), le stockage local des sauvegardes et le stockage du fournisseur de machine, ainsi que les quotas par titre et les détails sur le stockage local propre aux consoles.

​
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 de Game Saves.

​
Procédures pas à pas et exemples de Game Saves

Cet article décrit comment configurer Partner Center et comment utiliser des modèles d’écriture sécuritaires, comme l’écriture dans un fichier temporaire suivie de son remplacement atomique. Il décrit également comment gérer les scénarios hors ligne et hors réseau et comment utiliser les flux des boîtes de dialogue système. De plus, il explique comment gérer les données de Game Saves sur les appareils utilisés, tester le comportement de synchronisation avec le nuage et effectuer une migration entre des titres ou des API.

​
Débogage de Game Saves

Cet article explique les erreurs courantes de Game Save et les étapes de dépannage, notamment les problèmes de SCID, les pratiques exemplaires relatives à la durée de vie des handles, les limitations de quota et de mémoire, et la façon d’interpréter les codes NTSTATUS Win32.

​
Outils de 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 recommandée de synchronisation automatique avec le nuage pour Win32, des conseils sur les quotas et le débogage, des pratiques exemplaires en matière de performances et une FAQ.

​
Vue d’ensemble de l’API XGameSave

Cet article explique le modèle de stockage par conteneurs et blobs, la façon d’initialiser et de fermer les fournisseurs, et la façon dont les handles de mise à jour progressent dans leur cycle de vie. Il couvre également le comportement des mises à jour atomiques, les diagrammes de flux de synchronisation, les limites de taille de fichier et de quota, les pratiques exemplaires recommandées et une FAQ.
Last modified on October 6, 2026