Skip to main content
Ce guide constitue un point de départ pour l’intégration des fonctionnalités de Game Saves dans un titre. Il présente un aperçu de la terminologie essentielle, un résumé des API disponibles et des considérations importantes, comme les modèles d’utilisateur, la sécurité et les exigences de certification.

Vue d’ensemble

Les termes suivants sont utilisés dans l’ensemble de l’écosystème Game Saves.
  • Écosystème Game Saves : anciennement appelé Connected Storage ou XGameSave, cet écosystème gère la façon dont les jeux sauvegardent des données sur l’appareil et synchronisent ces données avec le nuage. L’écosystème organise les données sauvegardées en conteneurs et en blobs. Cette organisation aide les titres à stocker, à mettre à jour et à récupérer la progression des joueurs sur plusieurs appareils.
  • Titre : le jeu que vous développez.
  • Bac à sable (sandbox) : l’environnement dans lequel votre titre s’exécute.
  • Microsoft Partner Center : le portail Web de Microsoft qui gère la configuration et le bac à sable de votre titre.
  • Identificateur de configuration de service (SCID) : un identificateur unique de la configuration de service de votre titre dans les XBOX services.
  • ID d’application du compte Microsoft (MSA) (MSAAppID) : un identificateur requis qui lie un jeu à son identité de compte Microsoft. Cette valeur est générée dans Partner Center et placée dans MicrosoftGame.config afin que les XBOX services, notamment la connexion, les succès, les sauvegardes dans le nuage et les données utilisateur, puissent authentifier correctement le titre.
Les termes de service courants suivants apparaissent dans les API Game Saves.
  • Stockage local : les données sauvegardées pendant le jeu qui sont enregistrées sur un appareil.
  • Stockage du titre/nuage : le stockage est automatiquement synchronisé avec le stockage du titre dans le nuage lorsque l’appareil est connecté à Internet.
  • Verrou : un mécanisme qui accorde un accès exclusif aux Game Saves d’un titre pour un utilisateur précis sur l’appareil qu’il utilise activement. Un verrou garantit qu’aucun autre appareil ne peut modifier les Game Saves de l’utilisateur tant que le verrou est détenu.
    • Par exemple, si un utilisateur joue au titre T sur l’appareil A, celui-ci détient un verrou pour le titre T pour cet utilisateur.
  • Fournisseur : le mécanisme intermédiaire qui communique avec le système Game Save et qui est responsable de la gestion des données de jeu. Le fournisseur gère également le verrou d’un utilisateur sur un appareil.
  • Conteneurs : l’équivalent de dossiers.
  • Blobs : l’équivalent de fichiers individuels.

Nouveaux titres

Avant d’utiliser Game Saves, votre titre doit avoir les XBOX services activés dans Partner Center. Ce service fournit un SCID et un MSAAppID pour votre titre. Pour plus d’informations, consultez Activation des XBOX services et de Game Saves pour votre titre. Une fois Partner Center configuré, nous vous recommandons d’utiliser XGameSaveFiles pour l’implémentation de Game Saves.

API Game Saves

Modèles d’utilisateur

Deux types de modèles d’utilisateur sont pris en charge pour les jeux. Nous recommandons d’utiliser le modèle d’utilisateur simple. Pour plus d’informations sur les modèles d’utilisateur, consultez Modèles d’utilisateur du GDK. Pour plus d’informations sur les pratiques exemplaires de connexion des utilisateurs, consultez Procédure : pratique exemplaire pour connecter un utilisateur.

Sécurité

Données personnelles

Microsoft n’offre aucune API ni aucun outil permettant d’accéder aux données de Game Saves d’un utilisateur précis. Si vous avez besoin de ces informations pour résoudre un problème, communiquez directement avec l’utilisateur et demandez-lui de les partager.

Sauvegarde sécurisée

Les Game Saves ne sont pas sécurisées lorsque l’accessibilité PC est activée. Avec l’accessibilité PC, les utilisateurs peuvent ouvrir directement le chemin de fichier, ce qui expose les données sauvegardées. Nous vous recommandons d’avoir vos propres vérifications côté serveur pour confirmer l’état approprié d’une sauvegarde de jeu.

Exigences de certification

XR-052

XR-052 État de l’utilisateur et emplacement, itinérance et dépendances des sauvegardes de titre
Last modified on October 6, 2026