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

# Outils Game Saves

> Inspectez le trafic de Game Saves sur XBOX avec Fiddler et utilisez les outils en ligne de commande xbstorage et gamesaveutil pour exporter et importer des données de sauvegarde locales.

Cet article décrit l'utilisation de Fiddler pour inspecter le trafic réseau, les outils et techniques essentiels pour le débogage, ainsi que la manipulation de Game Saves.

## Inspection du trafic réseau de Game Saves

Utilisez Fiddler pour inspecter et déboguer le trafic réseau entrant et sortant de votre titre. Pour plus d'informations sur la configuration de Fiddler, consultez les articles suivants :

* [Fiddler sur les devkits XBOX](/fr/build/console-features/networking/tools/fiddler-setup-networking)
* [Fiddler sur PC Windows](/fr/build/console-features/networking/tools/fiddler-pc)

Fiddler confirme si le titre acquiert ou libère le verrou du titre, ce qui détermine quand les données sont synchronisées vers et depuis le cloud.

Voici la requête `PUT` lorsqu'un titre obtient un verrou avec succès.

```
PUT /connectedstorage/users/xuid(<XUID>)/scids/<TITLE SCID>/lock HTTP/1.1  
```

Voici la requête lorsqu'un titre libère un verrou.

```
DELETE /connectedstorage/users/xuid(<XUID>)/scids/<TITLE SCID>/lock HTTP/1.1
```

Le titre acquiert et libère le verrou à différents moments, selon l'API Game Saves utilisée.

| API Game Saves | Acquisition du verrou | Libération du verrou | Remarques |
| - | - | - | - |
| XGameSaveFiles | [XGameSaveFilesGetFolderWithUiAsync](/fr/reference/system/xgamesavefiles/functions/xgamesavefilesgetfolderwithuiasync) | Libère automatiquement le verrou lorsque l'appareil a fini de charger les modifications en attente. Ce processus prend environ 15 à 30 secondes après la fermeture du titre. | Réacquérez le verrou lorsque le titre reprend en appelant [XGameSaveFilesGetFolderWithUiAsync](/fr/reference/system/xgamesavefiles/functions/xgamesavefilesgetfolderwithuiasync). Le chemin du dossier renvoyé par l'appel d'API reste le même d'une session à l'autre. Le verrou peut ne plus être actif. |
| XGameSave | [XGameSaveInitializeProvider](/fr/reference/system/xgamesave/functions/xgamesaveinitializeprovider) ou [XGameSaveInitializeProviderAsync](/fr/reference/system/xgamesave/functions/xgamesaveinitializeproviderasync) | [XGameSaveCloseProvider](/fr/reference/system/xgamesave/functions/xgamesavecloseprovider) | Le titre appelle [XGameSaveCloseProvider](/fr/reference/system/xgamesave/functions/xgamesavecloseprovider) pour libérer les ressources du fournisseur. Ne pas l'appeler provoque une fuite de mémoire. |

Pour plus d'informations sur le processus de synchronisation, consultez [Comprendre le flux de synchronisation de Game Saves](/fr/build/core-features/common/game-save/game-saves-syncing)

## Manipulation de Game Saves

Deux outils sont disponibles pour interagir directement avec Game Saves.

* `xbstorage` : utilisé pour les sauvegardes Game Saves locales sur console. Pour plus d'informations, consultez [Gérer les données Game Saves sur console (xbstorage.exe)](/fr/tools/tools-console/commandlinetools/xbstorage).
* `xgamesaveutil` :  utilisé pour les sauvegardes Game Saves locales sur PC.  Pour plus d'informations, consultez [Gérer les données Game Saves sur PC (xgamesaveutil.exe)](/fr/tools/tools-pc/commandlinetools/gr-xgamesaveutil).

Ces outils vous permettent d'importer et d'exporter des espaces de stockage individuels d'utilisateur ou de fournisseur machine au moyen de fichiers .xml.
Pour obtenir la liste de toutes les opérations des outils, consultez l'article de l'outil correspondant.

<Info>Le comportement d'importation et d'exportation diffère entre la console et le PC. Consultez les détails ci-dessous et les pages des outils correspondants pour plus d'informations.</Info>

### Console (xbstorage)

Sur console, `xbstorage` fonctionne via le service Game Saves de la console. Lorsque l'outil effectue une opération, le système se comporte comme si le titre effectuait l'opération directement.

* L'**importation** de données amène la console à se synchroniser d'abord avec le cloud (acquisition d'un verrou et téléchargement des éventuelles modifications distantes), à écrire les données importées localement, puis à commencer à charger les données importées dans le cloud. Le chargement se termine en arrière-plan avant la libération du verrou.
* L'**exportation** de données amène la console à se synchroniser d'abord avec le cloud, puis à copier les données locales dans le fichier de sortie.

### PC (xgamesaveutil)

Sur PC, `xgamesaveutil` écrit les données directement sur le disque local sans passer par le service Game Saves.

* L'**importation** de données écrit les conteneurs et les blobs sur le disque local. L'outil ne se synchronise pas avec le cloud avant ou après l'importation, et ne déclenche pas de chargement vers le cloud. Les données importées sont chargées dans le cloud la prochaine fois que le titre se lance et acquiert le fournisseur Game Saves.
* L'**exportation** de données lit les conteneurs directement depuis le disque local. Elle ne se synchronise pas avec le cloud avant la lecture.

Si l'appareil exécutant l'un de ces outils ne peut pas acquérir de verrou ou détecte un conflit entre les conteneurs cloud et locaux, le système traite la situation comme si l'utilisateur n'allait pas résoudre le conflit. Dans cet état, l'appareil conserve une seule version du conteneur. L'appareil se comporte comme s'il était hors connexion jusqu'au prochain lancement du titre.

## Documentation de référence des API

* [XGameSave (contenu de l'API)](/fr/reference/system/xgamesave/xgamesave_members)
  * Fonctions
    * [XGameSaveInitializeProvider](/fr/reference/system/xgamesave/functions/xgamesaveinitializeprovider)
    * [XGameSaveInitializeProviderAsync](/fr/reference/system/xgamesave/functions/xgamesaveinitializeproviderasync)
    * [XGameSaveCloseProvider](/fr/reference/system/xgamesave/functions/xgamesavecloseprovider)
* [XGameSaveFiles (contenu de l'API)](/fr/reference/system/xgamesavefiles/xgamesavefiles_members)
  * Fonctions
    * [XGameSaveFilesGetFolderWithUiAsync](/fr/reference/system/xgamesavefiles/functions/xgamesavefilesgetfolderwithuiasync)

## Voir aussi

[Table des matières de Game Saves](/fr/build/core-features/common/game-save/game-saves-toc)


## Related topics

- [Save](/ko/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_save.md)
- [Game save](/build/core-features/common/game-save/index.md)
- [Game Save](/ja-jp/build/core-features/common/game-save/index.md)
- [XGameSave](/reference/system/xgamesave/xgamesave_members.md)
- [Game Saves debugging](/build/core-features/common/game-save/game-saves-debugging.md)
