> ## 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 de 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 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](/fr-CA/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-CA/build/core-features/common/game-save/xgamesavefiles) pour l'implémentation de Game Saves.

## API Game Saves

| API | Description | Plateformes | Cas d'utilisation | Exemple |
| - | - | - | - | - |
| [XGameSaveFiles](/fr-CA/build/core-features/common/game-save/xgamesavefiles) | Fournit un chemin de fichier pour le stockage local de Game Saves qui se synchronise automatiquement avec le nuage. | PC, XBOX | Nous recommandons cette API pour la plupart des scénarios. Fournit un chemin de fichier dans lequel vous pouvez lire et écrire, et qui se synchronise automatiquement avec le nuage. | [GameSaveFilesCombo](https://learn.microsoft.com/samples/microsoft/xbox-gdk-samples/gamesavefilescombo/) |
| [Sauvegardes dans le nuage sans code](/fr-CA/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 nuage. | 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-CA/build/core-features/common/game-save/xgamesave) | Les données sont sauvegardées localement et synchronisées avec le nuage. | PC, XBOX | Prend en charge les titres qui ont besoin d'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 recommandons d'utiliser le modèle d'utilisateur simple.

| Méthode | Description | Lien vers l'exemple | Différences entre les plateformes de vente au détail |
| - | - | - | - |
| 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 se termine 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-CA/build/core-features/common/user/gamecore-user-models).

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

## 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](https://learn.microsoft.com/build/store/policies/XR/XR052)


## Related topics

- [Vue d'ensemble de Game Saves](/fr-CA/build/core-features/common/game-save/game-saves-overview.md)
- [Game Saves (contenu)](/fr-CA/build/core-features/common/game-save/game-saves-toc.md)
- [Index de référence et liste des membres du wrapper XGameSave](/fr-CA/reference/system/Wrappers/xgamesave_wrapper_members.md)
- [Guide d'implémentation de PlayFab Game Saves sur Steam Deck](/fr-CA/services/playfab/player-progression/game-saves/steam-deck-implementation.md)
- [Sauvegarde de jeu](/fr-CA/build/core-features/common/game-save/index.md)