Notes de publication PlayFab 2020 - XBOX Game Development Documentation

Pour les notes de publication concernant les versions du service et les mises à jour du produit, consultez la section notes de publication du dépôt GitHub public de PlayFab

201218

Date : 2020-12-18

Corrections mineures de bogues

201207

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

Modifications propres au UnrealMarketplacePlugin

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

201119

Date : 2020-11-19

Modifications propres à la PostmanCollection

Ajout d’une connexion automatique pour la Title Entity, le cas échéant

Modifications propres au UnitySDK

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

Modifications propres au XPlat C++ SDK

Correction de la réponse de recherche QoS lorsque tous les serveurs dépassent le délai d’expiration.

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 également 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 frameworks. 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 d’aide, 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

Modifications propres au 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 aboutissent

Modifications 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 désormais en charge la fonctionnalité de thread d’arrière-plan
Lorsque le TitleId n’est pas défini, les méthodes d’API lèvent désormais des exceptions en temps réel de manière synchrone, au lieu de signaler le problème dans des rappels synchrones ou threadés

200422

Date : 2020-04-22

Mise à jour du NodeSDK :

Correctif logiciel
- Correction d’un problème où un fichier essentiel manquait dans les packages NPM récents, qui ne pouvaient donc pas être importés
- Correction d’un problème où certaines définitions de types étaient incorrectement définies sur “Number” au lieu des types appropriés

200421

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

200402

Date : 2020-04-02

Modifications de l’API

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

200330

Date : 2020-03-30

Modifications de l’API

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

Modifications propres au XPlat C++ SDK

Correction de certains problèmes de threading pour le PlayFabEventPipeline

Modifications propres au UnrealMarketPlacePlugin

Corrections de bogues de sécurité

200303

Date : 2020-03-03

Modifications de l’API

server.UnlinkXboxAccountRequest ne nécessite plus le XboxToken pour être dissocié
La fonctionnalité et l’API Experiments ont été publiées
- Consultez notre billet de blog pour plus de détails
Nouvelles méthodes
- client.LoginWithApple
- client.LinkApple
- client.UnlinkApple

200220

Date : 2020-02-20

Nouveautés

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

CPP Gsdk - Modification avec rupture de compatibilité

En raison de problèmes de 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

Modifications de l’API et de 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 désormais ê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
Modifications des méthodes d’API :
- Le paramètre de requête Region n’est plus obligatoire pour multiplayer.GetMultiplayerServerLogs

Modifications propres au CSharpSdk :

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

200213

Date : 2020-02-13 Les Multiplayer Servers de PlayFab introduisent une amélioration de la mise à l’échelle automatique nommée Dynamic Standby, qui surveille les niveaux de seuil des serveurs en veille et active dynamiquement un provisionnement accru de 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 être effectuée avec prudence. Vous pouvez configurer Dynamic Standby 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 de l’utilisateur dans la documentation en ligne de PlayFab Multiplayer Servers.

200128

Date : 2020-01-28

Modifications des événements Multiplayer Server :

Nous introduisons une modification de la convention de nommage des événements Multiplayer Server afin d’unifier nos noms d’événements avec le reste des noms d’événements PlayFab. De plus, nous apportons ces modifications avant que la fonctionnalité Multiplayer Server ne passe en préversion publique. Les modifications sont les suivantes :

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

Ces deux modifications constituent des modifications avec rupture de compatibilité, en particulier pour les développeurs qui dépendent d’une casse incorrecte des noms ou de PlayStream v1 pour les événements Multiplayer Server. Ces modifications n’entraînent pas de rupture 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). Cette modification prendra effet le mercredi 26 février 2020 à 10 h 00 PST. Adaptez votre code à ces modifications avant cette date. Modifications du 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
      }
}

La modification fondamentale du format 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
      }
}

Notez que les noms de propriétés des événements Multiplayer Server sont désormais mis à jour pour utiliser la casse PascalCasing. Cette modification aura un impact sur les clients qui traitent les événements 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 Multiplayer Server exportés seront également mises en forme en PascalCasing. Modifications du schéma La deuxième modification introduite est que les événements Multiplayer Server seront uniquement fournis au format PlayStream v2 et non plus au format PlayStream v1 hérité. 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 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. En revanche, les API qui accordent des objets aux entités généraient un événement PlayStream V2. Étant donné que les Multiplayer Servers ont été lancés 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 Multiplayer Server générait deux événements : un au format V1 et un au format V2. Pour supprimer cette duplication, les événements Multiplayer Server de l’espace de noms ‘com.playfab.events.multiplayer.servers’ sont dépréciés. Les événements de l’espace de noms ‘playfab.servers’ continueront d’être pris en charge. Pour distinguer les événements Multiplayer Server au format V1 de ceux 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

Modifications de l’API et de la documentation :

Le site de documentation de l’API 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
- Signalez-nous sur 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

Modifications propres au LuaSdk :

Correction mineure d’un bogue de connexion

Modifications propres au PhpSdk :

Correction mineure de syntaxe pour une exactitude stricte

Modifications propres au UnitySDK :

Mise à jour du dépôt GitHub et de la structure du projet.
- Déplacement du package Unity EdEx de (UnityEditorExtensions)[https://github.com/PlayFab/UnityEditorExtensions] vers (UnitySdk)[https://github.com/PlayFab/UnitySDK/blob/master/Packages/PlayFabEditorExtensions.unitypackage]
- À l’avenir, nous supprimerons également progressivement le dépôt UnityEditorExtensions distinct

​201218

​201207

​Modifications propres au UnrealMarketplacePlugin

​201119

​Modifications propres à la PostmanCollection

​Modifications propres au UnitySDK

​Modifications propres au XPlat C++ SDK

​201027

​201014

​200914

​200901

​200817

​200805

​200730

​200713

​200615

​200602

​200518

​Modifications propres au UnitySDK :

​Modifications propres au XPlat C++ SDK

​200422

​Mise à jour du NodeSDK :

​200421

​200402

​Modifications de l’API

​200330

​Modifications de l’API

​Modifications propres au XPlat C++ SDK

​Modifications propres au UnrealMarketPlacePlugin

​200303

​Modifications de l’API

​200220

​Nouveautés

​CPP Gsdk - Modification avec rupture de compatibilité

​200218

​Modifications de l’API et de la documentation :

​Modifications propres au CSharpSdk :

​200213

​200128

​Modifications des événements Multiplayer Server :

​200121

​Modifications de l’API et de la documentation :

​Modifications propres au LuaSdk :

​Modifications propres au PhpSdk :

​Modifications propres au UnitySDK :

201218

201207

Modifications propres au UnrealMarketplacePlugin

201119

Modifications propres à la PostmanCollection

Modifications propres au UnitySDK

Modifications propres au XPlat C++ SDK

201027

201014

200914

200901

200817

200805

200730

200713

200615

200602

200518

Modifications propres au UnitySDK :

Modifications propres au XPlat C++ SDK

200422

Mise à jour du NodeSDK :

200421

200402

Modifications de l’API

200330

Modifications de l’API

Modifications propres au XPlat C++ SDK

Modifications propres au UnrealMarketPlacePlugin

200303

Modifications de l’API

200220

Nouveautés

CPP Gsdk - Modification avec rupture de compatibilité

200218

Modifications de l’API et de la documentation :

Modifications propres au CSharpSdk :

200213

200128

Modifications des événements Multiplayer Server :

200121

Modifications de l’API et de la documentation :

Modifications propres au LuaSdk :

Modifications propres au PhpSdk :

Modifications propres au UnitySDK :