Notes de version de PlayFab 2020 - XBOX Game Development Documentation

Pour les notes de version sur les versions du service et les mises à jour du produit, consultez la section des notes de version du référentiel GitHub public de PlayFab

201218

Date : 2020-12-18

Correctifs de bogues mineurs

201207

Date : 2020-12-07 Prend en charge la version du service PlayFab du 2 décembre

Changements propres à l’UnrealMarketplacePlugin

Correction de problèmes liés aux paramètres statiques. Suivez le nouveau guide de mise à niveau.

201119

Date : 2020-11-19

Changements propres à la PostmanCollection

Ajout d’une connexion automatique pour l’entité Title, lorsque c’est approprié

Changements propres à l’UnitySDK

Correction d’un journal trop verbeux pour Unity 2020
Unity 2020 est maintenant entièrement pris en charge

Changements propres au XPlat C++ SDK

Correction de la réponse de recherche QoS lorsque tous les serveurs expirent.

201027

Date : 2020-10-27 Prend en charge la version du service PlayFab du 2 septembre Des mises à jour mineures ont été apportées aux API.

201014

Date : 2020-10-14 Prend en charge la version du service PlayFab du 2 septembre (Prend aussi en charge de nouvelles méthodes de l’API Experimentation, qui apparaîtront dans une prochaine version du service) PlayFab s’engage à vous permettre d’utiliser nos services pour développer des jeux multiplateformes et multiappareils à l’aide de divers moteurs de jeu et cadres. Pour nous aider à mieux nous concentrer sur la création des nouvelles fonctionnalités dont vous avez besoin, nous ouvrons les SDK suivants aux contributions de la communauté. Si vous avez d’autres questions ou avez besoin de soutien, rendez-vous sur le forum de la communauté PlayFab. Il s’agit de notre dernière mise à jour officielle des SDK suivants :

200914

Date : 2020-09-14 Prend en charge la version du service PlayFab du 2 septembre

200901

Date : 2020-09-01 Prend en charge la version du service PlayFab du 26 août

200817

Date : 2020-08-17 Prend en charge la version du service PlayFab du 12 août

200805

Date : 2020-08-05 Prend en charge la version du service PlayFab du 5 août

200730

Date : 2020-07-30 Prend en charge la version du service PlayFab du 15 juillet

200713

Date : 2020-07-13 Prend en charge la version du service PlayFab du 1er juillet

200615

Date : 2020-06-15 Prend en charge la version du service PlayFab du 10 juin

200602

Date : 2020-06-02 Prend en charge la version du service PlayFab du 27 mai

200518

Date : 2020-05-18 Prend en charge la version du service PlayFab du 13 mai

Changements propres à l’UnitySDK :

Le SDK PlayFab ne définit plus Application.runInBackground = true
- Il incombe aux développeurs de jeux de vérifier que les appels d’API effectués lors d’un changement de focus de l’application ou avant l’arrêt réussissent

Changements propres au XPlat C++ SDK

Dans l’implémentation HTTP CURL, davantage d’états d’erreur CURL sont surveillés et traités
La fonctionnalité Event Pipeline utilise et prend maintenant en charge la fonctionnalité de thread d’arrière-plan
Lorsque TitleId n’est pas défini, les méthodes d’API lèvent maintenant des exceptions en temps réel de façon synchrone, plutôt que de signaler le problème dans des rappels synchrones ou en thread

200422

Date : 2020-04-22

Mise à jour du NodeSDK :

Correctif logiciel
- Correction d’un problème où un fichier essentiel manquait dans les paquets NPM récents, ce qui empêchait leur importation
- Correction d’un problème où certaines définitions de type étaient incorrectement définies à « Number » plutôt qu’aux types appropriés

200421

Date : 2020-04-21 Les SDK prennent en charge le service PlayFab en date du 2020-04-21. Notes de version du service disponibles ici

200402

Date : 2020-04-02

Changements apportés aux API

Insights :
- Découvrez notre nouvelle fonctionnalité Insights!

200330

Date : 2020-03-30

Changements apportés aux API

Authentification :
- Ajout de nouveaux LoginIdentityProviders pour Apple et Nintendo
Multiplayer Server :
- Ajout de nouvelles fonctions de gestion de BuildRegion : DeleteBuildRegion et UpdateBuildRegion
UnrealMarketplacePlugin :
- Ajout de nouveaux scripts d’aide à la génération pour Mac

Changements propres au XPlat C++ SDK

Correction de certains problèmes de threads pour le PlayFabEventPipeline

Changements propres à l’UnrealMarketPlacePlugin

Correctifs de bogues de sécurité

200303

Date : 2020-03-03

Changements apportés aux API

server.UnlinkXboxAccountRequest ne nécessite plus le XboxToken pour supprimer la liaison
La fonctionnalité et l’API Experiments ont été lancées
- Consultez notre billet de blogue pour plus de détails
Nouvelles méthodes
- client.LoginWithApple
- client.LinkApple
- client.UnlinkApple

200220

Date : 2020-02-20

Nouveautés

Automatisation - Nous avons lancé une nouvelle extension Visual Studio Code pour PlayFab. Vous trouverez le code source sur GitHub.

CPP Gsdk - Changement cassant

En raison de préoccupations liées à la sécurité des threads, les signatures des méthodes suivantes ont été modifiées :

Nom de la méthode	Ancien type de retour	Nouveau type de retour
`GSDK::getConfigSettings()`	`const std::unordered_map <std::string, std::string>&`	`const std::unordered_map <std::string, std::string>`
`GSDK::getLogsDirectory()`	`const std::string&`	`const std::string`
`GSDK::getSharedContentDirectory()`	`const std::string&`	`const std::string`

Consultez notre guide de mise à niveau

200218

Date : 2020-02-18

Changements apportés aux API et à la documentation :

Nouvelles méthodes d’API :
- admin.CreateInsightsScheduledScalingTask
- multiplayer.GetMultiplayerSessionLogsBySessionId
Nouvelle fonctionnalité et nouvelles méthodes :
- Un nouveau mécanisme pour Cloud Script, les fonctions Azure, peut maintenant être utilisé dans PlayFab
- Documentation de la fonctionnalité
- Liste des nouvelles méthodes :
  - cloudscript.ExecuteFunction
  - cloudscript.ListFunctions
  - cloudscript.ListHttpFunctions
  - cloudscript.ListQueuedFunctions
  - cloudscript.PostFunctionResultForEntityTriggeredAction
  - cloudscript.PostFunctionResultForFunctionExecution
  - cloudscript.PostFunctionResultForScheduledTask
  - cloudscript.RegisterHttpFunction
  - cloudscript.RegisterQueuedFunction
  - cloudscript.UnregisterFunction
Changements apportés aux méthodes d’API :
- Le paramètre de requête Region n’est plus requis pour multiplayer.GetMultiplayerServerLogs

Changements propres au CSharpSdk :

Refonte et amélioration du calcul du ping QoS pour PlayFab Multiplayer

200213

Date : 2020-02-13 PlayFab Multiplayer Servers introduit une amélioration de la mise à l’échelle automatique appelée Dynamic Standby, qui surveille les niveaux de seuil des serveurs en attente et active dynamiquement un approvisionnement accru en serveurs de jeu afin de répondre à la demande à grande échelle. Cette fonctionnalité ajoute un nouvel objet à l’interface de programmation Multiplayer, appelé objet « DynamicStandby ». L’objet Dynamic Standby est une propriété facultative de l’objet BuildRegionParams. Dynamic Standby est une fonctionnalité avancée des serveurs de jeu, et la modification de ses paramètres par rapport à leurs valeurs par défaut doit se faire avec prudence. La configuration de Dynamic Standby peut se faire dans le portail des développeurs Game Manager ou en modifiant par programmation les propriétés de l’objet Dynamic Standby. Pour en savoir plus sur Dynamic Standby, consultez son guide d’utilisation dans la documentation en ligne de PlayFab Multiplayer Servers.

200128

Date : 2020-01-28

Changements apportés aux événements de Multiplayer Server :

Nous apportons un changement à la convention d’affectation de noms des événements de Multiplayer Server afin d’uniformiser nos noms d’événements avec les autres noms d’événements de PlayFab. De plus, nous apportons ces changements avant que la fonctionnalité Multiplayer Server passe en préversion publique. Les changements sont les suivants :

Les noms des événements de Multiplayer Server seront mis à jour pour utiliser la casse PascalCasing
Les événements de Multiplayer Server ne seront plus envoyés dans l’ancien format d’événement PlayStream v1; seul le format d’événement PlayStream v2 sera pris en charge

Ces deux changements constituent des changements cassants, particulièrement pour les développeurs qui dépendent d’une casse incorrecte des noms ou de PlayStream v1 pour les événements de Multiplayer Server. Ces changements ne sont pas cassants pour les développeurs qui utilisent les noms d’événements dans l’interface utilisateur de Game Manager (cloud script, insights, règles ou tâches planifiées). Ce changement entrera en vigueur le mercredi 26 février 2020 à 10 h (HNP). Adaptez votre code à ces changements avant la date du changement. Changements de format En général, les événements PlayFab ont un format semblable à celui-ci :

{
   'Event Name':'my_event'
   'Payload':
   {
      'prop1':1
      'prop2':2
      'camelcase':3
      }
}

Le changement de format fondamental est que les propriétés de l’objet Payload des événements seront mises à jour pour utiliser la casse PascalCasing, par souci de cohérence avec les autres événements PlayStream. Par conséquent, les nouveaux noms de propriétés respecteront le format suivant :

{
   'Event Name':'my_event'
   'Payload':
   {
      'Prop1':1
      'Prop2':2
      'CamelCase':3
      }
}

Remarquez que les noms de propriétés des événements de Multiplayer Server sont maintenant mis à jour pour utiliser la casse PascalCasing. Ce changement aura une incidence sur les clients qui traitent les événements de Multiplayer Server dans (a) des requêtes Kusto ou (b) des cloud scripts PlayFab. Enfin, si un client utilise la fonctionnalité PlayFab Event Archive (actuellement en préversion publique), les propriétés des événements de Multiplayer Server exportés seront aussi mises en forme selon la casse PascalCasing. Changements de schéma Le deuxième changement introduit est que les événements de Multiplayer Server seront uniquement livrés au format PlayStream v2 et non plus à l’ancien format PlayStream v1. PlayFab prend actuellement en charge deux schémas d’événements.

Format du schéma	Description	Valeur de l’espace de noms des événements Multiplayer
PlayStream V1	Conçu autour des événements de joueur	com.playfab.events.multiplayer
PlayStream V2	Conçu autour des événements d’entité	playfab.servers

En général, les API de PlayFab génèrent des événements au format PlayStream V1 ou au format PlayStream V2. Par exemple, les API qui accordent des objets aux joueurs généraient un événement PlayStream V1, tandis que les API qui accordent des objets aux entités généraient un événement PlayStream V2. Comme Multiplayer Servers a été lancé en préversion publique au même moment ou presque que l’introduction de PlayStream V2, la fonctionnalité Multiplayer Server prenait en charge les formats PlayStream V1 et V2. Autrement dit, chaque appel d’API de Multiplayer Server générait deux événements : un au format V1 et un au format V2. Pour éliminer cette duplication, les événements de Multiplayer Server dans l’espace de noms ‘com.playfab.events.multiplayer.servers’ sont dépréciés. Les événements dans l’espace de noms ‘playfab.servers’ continueront d’être pris en charge. Pour distinguer les événements de Multiplayer Server au format V1 et au format V2, examinez la propriété d’espace de noms de l’événement. L’espace de noms est indiqué dans la troisième colonne du tableau ci-dessus. La représentation JSON ressemble au format suivant :

{
   'FullName':
   {
      'Namespace':'abc',
      'Name':'xyz'
   }
}

La propriété à rechercher s’appelle Namespace.

200121

Date : 2020-01-21

Changements apportés aux API et à la documentation :

Le site de documentation des API de PlayFab a été entièrement migré vers /gaming/playfab
- La plupart des liens api.playfab.com ont été convertis en leurs liens learn.microsoft.com équivalents
- La plupart des liens d’origine redirigent correctement vers le nouveau site
- Faites-nous savoir dans les forums si d’anciens liens ne fonctionnent pas
Nouvelles méthodes d’API :
- multiplayer.ListServerBackfillTicketsForPlayer
- multiplayer.GetServerBackfillTicket
- multiplayer.CreateServerBackfillTicket
- multiplayer.CancelServerBackfillTicket
- multiplayer.CancelAllServerBackfillTicketsForPlayer
- server.UnlinkPSNAccount
- server.LinkPSNAccount

Changements propres au LuaSdk :

Correctif de bogue mineur lié à la connexion

Changements propres au PhpSdk :

Correction mineure de syntaxe pour une exactitude stricte

Changements propres à l’UnitySDK :

Mise à jour du référentiel GitHub et de la structure du projet.
- Déplacement du paquet Unity EdEx de (UnityEditorExtensions)[https://github.com/PlayFab/UnityEditorExtensions] vers (UnitySdk)[https://github.com/PlayFab/UnitySDK/blob/master/Packages/PlayFabEditorExtensions.unitypackage]
- À l’avenir, nous abandonnerons aussi progressivement le référentiel distinct UnityEditorExtensions

​201218

​201207

​Changements propres à l’UnrealMarketplacePlugin

​201119

​Changements propres à la PostmanCollection

​Changements propres à l’UnitySDK

​Changements propres au XPlat C++ SDK

​201027

​201014

​200914

​200901

​200817

​200805

​200730

​200713

​200615

​200602

​200518

​Changements propres à l’UnitySDK :

​Changements propres au XPlat C++ SDK

​200422

​Mise à jour du NodeSDK :

​200421

​200402

​Changements apportés aux API

​200330

​Changements apportés aux API

​Changements propres au XPlat C++ SDK

​Changements propres à l’UnrealMarketPlacePlugin

​200303

​Changements apportés aux API

​200220

​Nouveautés

​CPP Gsdk - Changement cassant

​200218

​Changements apportés aux API et à la documentation :

​Changements propres au CSharpSdk :

​200213

​200128

​Changements apportés aux événements de Multiplayer Server :

​200121

​Changements apportés aux API et à la documentation :

​Changements propres au LuaSdk :

​Changements propres au PhpSdk :

​Changements propres à l’UnitySDK :

201218

201207

Changements propres à l’UnrealMarketplacePlugin

201119

Changements propres à la PostmanCollection

Changements propres à l’UnitySDK

Changements propres au XPlat C++ SDK

201027

201014

200914

200901

200817

200805

200730

200713

200615

200602

200518

Changements propres à l’UnitySDK :

Changements propres au XPlat C++ SDK

200422

Mise à jour du NodeSDK :

200421

200402

Changements apportés aux API

200330

Changements apportés aux API

Changements propres au XPlat C++ SDK

Changements propres à l’UnrealMarketPlacePlugin

200303

Changements apportés aux API

200220

Nouveautés

CPP Gsdk - Changement cassant

200218

Changements apportés aux API et à la documentation :

Changements propres au CSharpSdk :

200213

200128

Changements apportés aux événements de Multiplayer Server :

200121

Changements apportés aux API et à la documentation :

Changements propres au LuaSdk :

Changements propres au PhpSdk :

Changements propres à l’UnitySDK :