> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Guide du développeur Game Saves

> Intégrez Game Saves du GDK XBOX dans un titre grâce à des conseils sur la terminologie, les API XGameSave et XGameSaveFiles, les modèles d'utilisateur, la PLM, la sécurité et la certification.

Ce guide constitue un point de départ pour intégrer les fonctionnalités Game Saves dans un titre. Il présente la terminologie essentielle, un aperçu des API disponibles et des considérations importantes, telles que les modèles d'utilisateur, la sécurité et les exigences de certification.

## 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.

Les termes de service courants suivants apparaissent dans les API Game Saves.

* **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](/fr/build/core-features/common/game-save/game-saves-walkthroughs-and-samples#enabling-xbox-services-and-game-saves-for-your-title).

Une fois Partner Center configuré, nous vous recommandons d'utiliser [XGameSaveFiles](/fr/build/core-features/common/game-save/xgamesavefiles) pour l'implémentation de Game Saves.

## API Game Saves

| API | Description | Plateformes | Cas d'usage | Exemple |
| - | - | - | - | - |
| [XGameSaveFiles](/fr/build/core-features/common/game-save/xgamesavefiles) | Fournit un chemin de fichier pour le stockage local Game Saves qui se synchronise automatiquement avec le cloud. | PC, XBOX | Nous recommandons cette API pour la plupart des scénarios. Fournit un chemin de fichier dans lequel lire/écrire et qui se synchronise automatiquement avec le cloud. | [GameSaveFilesCombo](https://learn.microsoft.com/samples/microsoft/xbox-gdk-samples/gamesavefilescombo/) |
| [Sauvegardes cloud sans code](/fr/build/core-features/common/game-save/game-saves-walkthroughs-and-samples#porting-previous-titles-to-pc-game-saves-with-no-code-cloud-saves) | Vous fournissez un chemin de fichier qui est automatiquement synchronisé avec le cloud. | PC | Idéal pour les jeux PC qui ne peuvent pas utiliser directement le GDK ou qui sont portés vers PC Game Pass. Fournit le chemin de lecture/écriture dans le fichier .config du jeu. | Aucun |
| [XGameSave](/fr/build/core-features/common/game-save/xgamesave) | Les données sont enregistrées localement et synchronisées avec le cloud. | PC, XBOX | Prend en charge les titres qui nécessitent un stockage par utilisateur plus volumineux ou plus complexe. Offre un contrôle détaillé de la gestion des fichiers. | [GameSaveCombo](https://learn.microsoft.com/samples/microsoft/xbox-gdk-samples/gamesavecombo/) |

## 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.

| Méthode | Description | Lien vers l'exemple | Différences selon la plateforme commerciale |
| - | - | - | - |
| Modèle d'utilisateur simple | Un utilisateur par défaut est requis. Il contrôle la durée de vie de l'instance du jeu. Le système d'exploitation garantit qu'un utilisateur se connecte au lancement du jeu. | [SimpleUserModel](https://learn.microsoft.com/samples/microsoft/xbox-gdk-samples/simpleusermodel/) | PC : le jeu s'arrête lorsque l'utilisateur par défaut se déconnecte.<br /><br /> Console : le jeu est suspendu lorsque l'utilisateur par défaut se déconnecte. |
| Modèle d'utilisateur avancé | Aucun utilisateur par défaut. Rien ne garantit qu'un utilisateur est connecté au lancement du jeu. | Aucun | Aucune |

Pour plus d'informations sur les modèles d'utilisateur, consultez [Modèles d'utilisateur du GDK](/fr/build/core-features/common/user/gamecore-user-models).

Pour plus d'informations sur les bonnes pratiques de connexion des utilisateurs, consultez [Procédure : bonnes pratiques pour connecter un utilisateur](/fr/build/core-features/common/user/xuser_howto_best_practice_signing_in).

## Sécurité

### Données personnelles

Microsoft ne propose aucune API ni aucun outil permettant d'accéder aux données Game Saves d'un utilisateur spécifique. Si vous avez besoin de ces informations pour résoudre un problème, contactez directement l'utilisateur et demandez-lui de les partager.

### Enregistrement sécurisé

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 enregistrées. Nous vous recommandons de mettre en place vos propres vérifications côté serveur pour confirmer l'état approprié d'une sauvegarde de jeu.

## Exigences de certification

### XR-052

[XR-052 User State and Title-Save Location, Roaming, and Dependencies](https://learn.microsoft.com/build/store/policies/XR/XR052)


## Related topics

- [Game Saves developer guide](/build/core-features/common/game-save/game-saves-developer-guide.md)
- [Steam Deck Implementation Guide for PlayFab Game Saves](/services/playfab/player-progression/game-saves/steam-deck-implementation.md)
- [Game Saves overview](/build/core-features/common/game-save/game-saves-overview.md)
- [Guide des BVT de certification pour PC](/fr-CA/publishing/game-publishing/concepts/certification/certification-pc-bvt-guide.md)
- [Ressources d'accessibilité pour les développeurs](/fr/build/game-principles/accessibility/accessibility-resources.md)