Vue d’ensemble
Les termes suivants apparaissent dans tout l’écosystème Game Saves.- Écosystème Game Saves : auparavant appelé Connected Storage ou
XGameSave, cet écosystème gère la manière dont les jeux enregistrent des données sur l’appareil et synchronisent ces données avec le cloud. L’écosystème organise les données enregistrées en conteneurs et en blobs. Cette organisation aide les titres à stocker, mettre à jour et récupérer la progression des joueurs sur tous les appareils. - Titre : le jeu que vous développez.
- Sandbox : l’environnement dans lequel votre titre s’exécute.
- Microsoft Partner Center : le portail web de Microsoft qui gère la configuration et la sandbox de votre titre.
- Identificateur de configuration de service (SCID) : identificateur unique de la configuration de service de votre titre au sein des services XBOX.
- ID d’application de compte Microsoft (MSA) (MSAAppID) : 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 services XBOX, notamment la connexion, les succès, les sauvegardes cloud et les données utilisateur, puissent authentifier correctement le titre.
- Stockage local : données enregistrées pendant le jeu sur un appareil.
- Stockage de titre/cloud : le stockage est automatiquement synchronisé avec le stockage de titre dans le cloud lorsque l’appareil est connecté à Internet.
- Verrou : mécanisme qui accorde un accès exclusif aux Game Saves d’un titre pour un utilisateur spécifique 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 sur le titre T pour l’utilisateur.
- Fournisseur : mécanisme intermédiaire qui communique avec le système Game Save et qui est chargé de gérer les données de jeu. Le fournisseur gère également le verrou d’un utilisateur sur un appareil.
- Conteneurs : analogues à des dossiers.
- Blobs : analogues à des fichiers individuels.
Nouveaux titres
Avant d’utiliser Game Saves, les services XBOX doivent être activés pour votre titre dans Partner Center. Ce service fournit un SCID et un MSAAppID pour votre titre. Pour plus d’informations, consultez Activation des services XBOX 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 vous 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 bonnes pratiques de connexion des utilisateurs, consultez Procédure : bonnes pratiques pour connecter un utilisateur.