Procédures pas à pas et exemples Game Saves

​

Configurations de Partner Center

​

Activation des services XBOX et de Game Saves pour votre titre

• Activez les services XBOX.
  1. Connectez-vous à Partner Center.
  2. Accédez à votre titre, puis activez les services XBOX dans les paramètres. Pour plus d’informations sur cette étape, consultez Configuration d’une application ou d’un jeu dans Partner Center, pour les partenaires gérés.
• Obtenez votre identificateur de configuration de service (SCID). Toutes les opérations de lecture et d’écriture doivent être associées à un SCID. Le SCID est également utilisé pour l’initialisation de Game Saves.
  • Dans Partner Center, recherchez le SCID sous l’onglet XBOX services > XBOX settings de votre titre. Vous pouvez également trouver l’ID d’application de votre compte Microsoft (MSA) (MSAAppID) sur cette page.

​

Scénarios de développement

​

Où intégrer Game Saves dans mon code ?

​

Comment m’assurer que mes données de sauvegarde de jeu ne sont pas endommagées ?

1. Écrivez dans un fichier temporaire.
   • Sérialisez vos données de sauvegarde dans un nouveau fichier (par exemple, save.tmp) au lieu d’écraser la sauvegarde active. Cette étape protège la sauvegarde existante si votre processus est interrompu en cours d’écriture.
2. Fermez le handle d’écriture une fois l’écriture entièrement validée sur le disque.
3. Remplacez de manière atomique l’ancien fichier de sauvegarde par le nouveau fichier temporaire à l’aide de la fonction Win32 ReplaceFile.

​

Comment prendre en charge les appareils hors connexion ?

​

Quelles interactions utilisateur dois-je connaître ?

​

Est-il possible d’enregistrer uniquement en local, sur l’appareil ?

​

Gestion des sauvegardes de jeu via l’appareil

​

Accès aux sauvegardes de jeu locales sur PC à l’aide de l’Explorateur de fichiers

​

Accès aux sauvegardes de jeu locales sur console

1. Sélectionnez le bouton Accueil de la manette XBOX.
2. Sélectionnez Mes jeux et applications > Tout afficher.
3. Placez le curseur sur votre jeu, puis sélectionnez le bouton Affichage.
4. Sélectionnez Données enregistrées.

• La suppression de données sur la console à l’aide de l’interface système ne supprime pas la copie stockée dans le cloud. Lorsque vous relancez le titre, il synchronise les données depuis le cloud.
• Les données du fournisseur machine apparaissent comme un utilisateur sans nom. Ces données restent sur l’appareil, ne se synchronisent pas avec le cloud et sont liées à l’appareil.

​

Scénarios de test

​

Tester si les sauvegardes de jeu se synchronisent correctement vers et depuis le cloud

1. Vérifiez que le SCID est correct.
2. Vérifiez que vous utilisez le bon handle d’utilisateur.
3. Vérifiez que le titre appelle XGameSaveFilesGetFolderWithUIAsync pendant la session de jeu actuelle. Si le titre reprend après une suspension, appelez la fonction.
   1. Utilisez Fiddler pour vérifier que le verrou a été acquis.
   2. Enregistrez ce chemin et utilisez-le plus tard pour vérifier que les données sont en cours de chargement.
4. Écrivez des données dans le chemin de fichier fourni par XGameSaveFilesGetFolderWithUIAsync.
5. Arrêtez ou suspendez le titre.
6. Attendez 10 à 30 secondes que le système d’exploitation charge automatiquement les données dans le cloud et libère le verrou.
   1. Vérifiez à l’aide de Fiddler que les données ont été chargées et que le verrou a été libéré.
7. Supprimez manuellement les données du dossier fourni par XGameSaveFilesGetFolderWithUIAsync.
   1. Sur console, accédez à ces données via les paramètres du joueur.
8. Relancez le titre, puis tentez de connecter l’utilisateur.
9. Une boîte de dialogue de synchronisation apparaît, indiquant une synchronisation de téléchargement active depuis le cloud.

• Outils Game Saves pour inspecter le trafic et manipuler les sauvegardes
• Comprendre le flux de synchronisation de Game Saves

​

Tester si les sauvegardes de jeu sont correctement itinérantes

​

Scénarios de migration

​

Partage de sauvegardes de jeu entre titres

1. Modifiez les stratégies d’accès du titre auquel vous souhaitez accéder dans Partner Center.
2. Initialisez les fournisseurs Game Saves des deux titres dans le code source.

​

Modifier les stratégies d’accès

1. Accédez à Partner Center.
2. Sélectionnez Apps and games > <votre titre> > Gameplay settings.
3. Dans Gameplay Settings, sélectionnez Access Policies, puis développez Connected Storage.
4. Sélectionnez Add app/service, puis ajoutez les titres auxquels vous souhaitez donner accès.
5. Lorsque vous avez terminé d’ajouter les titres, sélectionnez Save, puis Publish. Les modifications prennent effet dans un délai d’une heure.

​

Initialiser les fournisseurs Game Save

• Si vous utilisez XGameSave, appelez XGameSaveInitializeProvider ou XGameSaveInitializeProviderAsync pour chaque titre.
• Si vous utilisez XGameSaveFiles, les fournisseurs sont initialisés implicitement. Appelez XGameSaveFilesGetFolderWithUiAsync pour chaque titre.

​

Interopérabilité entre XGameSave et XGameSaveFiles

• L’éditeur dispose d’un titre existant sur console qui utilise déjà XGameSave.
• L’éditeur ne souhaite pas mettre à jour ce titre existant pour utiliser XGameSaveFiles.
• L’éditeur estime qu’il est plus facile d’ajouter XGameSaveFiles à un titre PC que d’utiliser XGameSave, mais souhaite tout de même prendre en charge les sauvegardes croisées entre PC, console et le streaming de jeux XBOX.

• Toute barre oblique (/) dans le nom du conteneur crée la structure de répertoires dans laquelle se trouve le fichier.
• Les caractères suivants ne sont pas valides pour XGameSaveFiles. Si le système rencontre ces caractères, il les remplace par un trait de soulignement (_) :
  • Caractères de \0 à \001f inclus.
• Les caractères suivants ne sont pas valides pour XGameSaveFiles. Si le système rencontre ces caractères, il les remplace par un point (.) :
  • Guillemets (”)
  • Signe inférieur à (<)
  • Signe supérieur à (>)
  • Barre verticale (|)
  • Astérisque (*)
  • Point d’interrogation (?)
  • Barre oblique inverse (\)
• Une barre oblique (/) dans le nom du blob est remplacée par un point (.) dans le nom du fichier.
• Les fichiers sont limités à 16 Mo. XGameSave prend en charge une taille de chargement maximale de 16 Mo.

​

Portage de titres antérieurs vers Game Saves sur PC avec les sauvegardes cloud sans code

• Le titre s’exécute en tant qu’application x86. Il n’utilise le Microsoft Game Development Kit (GDK) que sous sa forme empaquetée.
• Le titre est créé sans code personnalisé, à l’aide d’outils tels que Blueprint dans Unreal Engine ou Bolt dans Unity.

• Le titre est arrêté.
• L’utilisateur suivi se déconnecte.
• L’état d’alimentation du PC change.
• 30 minutes se sont écoulées depuis la dernière écriture du titre dans la zone de sauvegarde désignée.

​

Activation des sauvegardes cloud sans code

1. Modifiez votre fichier MicrosoftGame.config.
2. Activez le modèle utilisateur simplifié.
3. Spécifiez le dossier racine des fichiers de sauvegarde.
4. Fournissez le SCID correspondant au titre.

<Game configVersion="1">
   <Identity Name="SampleNameOne" Publisher="CN=NoPublisher"/>
   <SaveGameStorage>
      <NoCodePCRoot RelativeTo="SavedGames">test\path</NoCodePCRoot>
      <SCID>DF9D8061-4790-4B84-86B4-CD060B00B4DD</SCID>
      <MaxUserQuota>256</MaxUserQuota>
   </SaveGameStorage>
   <!-- Content removed for brevity -->
   
   <!-- Must also opt into requiring a default user at launch -->
   <AdvancedUserModel>false</AdvancedUserModel>
</Game>

​

Exemples de code

• GameSaveCombo
• GameSaveFilesCombo

​

Documentation de référence des API

• XGameSaveFiles (contenu de l’API)
  • Fonctions
    • XGameSaveFilesGetFolderWithUiAsync

​

Voir aussi