Procédures pas à pas et exemples de Game Saves

​

Configurations dans Partner Center

​

Activer les services XBOX et 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 en savoir plus 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 sert également à l’initialisation de Game Saves.
  • Dans Partner Center, trouvez le SCID sous l’onglet XBOX services > XBOX settings de votre titre. Vous pouvez également trouver l’ID d’application (MSAAppID) de votre compte Microsoft (MSA) sur cette page.

​

Scénarios de développement

​

Où dois-je intégrer Game Saves dans mon code?

​

Comment m’assurer que mes données de sauvegarde ne deviennent pas corrompues?

1. Écrivez dans un fichier temporaire.
   • Sérialisez vos données de sauvegarde dans un nouveau fichier (par exemple, save.tmp) plutôt que 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 l’ancien fichier de sauvegarde de façon atomique par le nouveau fichier temporaire au moyen de la fonction Win32 ReplaceFile.

​

Comment prendre en charge les appareils hors ligne?

​

De quelles interactions utilisateur dois-je tenir compte?

​

Existe-t-il un moyen de sauvegarder localement et uniquement sur l’appareil?

​

Gérer Game Saves au moyen de l’appareil

​

Accéder aux sauvegardes locales sur PC au moyen de l’Explorateur de fichiers

​

Accéder aux sauvegardes 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 sauvegardées.

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

​

Scénarios de test

​

Vérifier si les sauvegardes se synchronisent correctement vers le nuage et à partir de celui-ci

1. Confirmez que le SCID est correct.
2. Confirmez que vous utilisez le bon handle d’utilisateur.
3. Confirmez que le titre appelle XGameSaveFilesGetFolderWithUIAsync pendant la session de jeu en cours. Si le titre reprend à partir d’un état suspendu, appelez la fonction.
   1. Utilisez Fiddler pour confirmer que le verrou a été acquis.
   2. Enregistrez ce chemin et utilisez-le plus tard pour confirmer que les données sont téléversées.
4. Écrivez des données dans le chemin de fichier fourni par XGameSaveFilesGetFolderWithUIAsync.
5. Arrêtez ou suspendez le titre.
6. Attendez de 10 à 30 secondes pour que le système d’exploitation téléverse automatiquement les données dans le nuage et libère le verrou.
   1. Confirmez au moyen de Fiddler que les données ont été téléversées et que le verrou a été libéré.
7. Supprimez manuellement les données dans le dossier fourni par XGameSaveFilesGetFolderWithUIAsync.
   1. Sur console, accédez à ces données au moyen des paramètres du joueur.
8. Relancez le titre, puis tentez de connecter l’utilisateur.
9. Une boîte de dialogue de synchronisation s’affiche, montrant une synchronisation de téléchargement active à partir du nuage.

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

​

Vérifier si les sauvegardes sont itinérantes correctement

​

Scénarios de migration

​

Partager des sauvegardes entre titres

1. Modifiez les stratégies d’accès du titre auquel vous voulez 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 voulez donner accès.
5. Lorsque vous avez terminé d’ajouter les titres, sélectionnez Save, puis Publish. Les modifications prennent effet dans l’heure qui suit.

​

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 a un titre existant sur console qui utilise déjà XGameSave.
• L’éditeur ne veut pas mettre à jour ce titre existant pour utiliser XGameSaveFiles.
• L’éditeur estime qu’ajouter XGameSaveFiles à un titre PC est plus facile que d’utiliser XGameSave, mais souhaite tout de même prendre en charge les sauvegardes croisées entre PC, console et la diffusion de jeux XBOX en continu.

• 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 mappe à un trait de soulignement (_) :
  • Les caractères de \0 à \001f, inclusivement.
• Les caractères suivants ne sont pas valides pour XGameSaveFiles. Si le système rencontre ces caractères, il les mappe à 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 mappée à un point (.) dans le nom du fichier.
• Les fichiers sont limités à 16 Mo. XGameSave prend en charge une taille de téléversement maximale de 16 Mo.

​

Porter des titres antérieurs vers Game Saves sur PC avec les sauvegardes infonuagiques sans code

• Le titre s’exécute en tant qu’application x86. Il utilise le Microsoft Game Development Kit (GDK) uniquement sous sa forme empaquetée.
• Le titre est créé sans code personnalisé, au moyen d’outils comme 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.

​

Activer les sauvegardes infonuagiques sans code

1. Modifiez votre fichier MicrosoftGame.config.
2. Activez le modèle d’utilisateur simplifié.
3. Indiquez le dossier racine des fichiers de sauvegarde.
4. Fournissez le SCID correspondant du 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 de l’API

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

​

Voir aussi