Vue d’ensemble
Le SDK C/C++ PlayFab Services autonome (publié en 2023) a introduit des pratiques de développement modernes, telles que l’actualisation automatique des jetons, une meilleure gestion de la mémoire et un contrôle accru des threads. Cependant, les autres SDK autonomes, comme PlayFab Party et PlayFab Multiplayer, n’ont pas adopté ces améliorations. Le SDK unifié réunit ces composants dans un SDK cohérent et modernisé.Les SDK autonomes PlayFab existants (v1) restent pris en charge, mais nous recommandons le SDK unifié PlayFab (v2) pour les nouveaux projets.
Principaux avantages
Le SDK unifié apporte des améliorations significatives par rapport aux SDK autonomes :- Intégration simplifiée : un processus unique d’installation et de mise à jour du SDK évite d’avoir à gérer plusieurs téléchargements et versions de SDK. Sur XBOX/Windows, le SDK est fourni avec le GDK (à partir du GDK d’octobre 2025, version 2510).
-
Authentification unifiée : l’authentification est effectuée une seule fois au moyen des API
PFAuthentication, et lePFEntityHandleobtenu est utilisé par tous les composants. Les composants interrogent automatiquement le service Core en interne pour obtenir les jetons, ce qui élimine la transmission manuelle des jetons et réduit les erreurs d’intégration. - Gestion automatique des jetons : une logique centralisée d’actualisation des jetons gère automatiquement le renouvellement de l’Entity Token en arrière-plan, ce qui évite l’expiration de la session pendant les longues sessions de jeu.
- Modèle de programmation cohérent : tous les composants suivent des modèles standardisés pour l’initialisation, les appels d’API, la gestion des erreurs, les opérations asynchrones et la journalisation unifiée, ce qui réduit considérablement la courbe d’apprentissage.
-
Contrôle avancé des threads et gestion de la mémoire : tous les composants prennent en charge les allocateurs de mémoire personnalisés et le contrôle avancé des threads grâce à l’intégration de
XTaskQueue, ce qui permet un contrôle précis de l’allocation des ressources et du comportement des threads.
Plateformes et moteurs de jeu pris en charge
Le tableau suivant indique la prise en charge des plateformes et des moteurs de jeu par le SDK unifié PlayFab :L’accès aux SDK des plateformes PlayStation® et Nintendo nécessite un accord de confidentialité (NDA) avec le détenteur de la plateforme concernée. Pour plus de détails, consultez Demander l’accès aux SDK et aux exemples.
Disponibilité des fonctionnalités
Les composants du SDK unifié sont livrés ensemble, mais certaines fonctionnalités peuvent avoir une disponibilité limitée ou provisoire sur certaines plateformes dans la version actuelle. Le tableau suivant résume l’état de préparation des fonctionnalités pour cette préversion.
Un tiret (—) indique que la fonctionnalité n’est actuellement pas prise en charge sur cette plateforme.
Si vous constatez une différence entre ce tableau et le comportement observé, signalez un problème au moyen de votre canal de soutien PlayFab afin que l’équipe produit puisse mettre à jour la documentation et combler l’écart.
Composants du SDK
Le SDK unifié PlayFab présente une architecture modulaire qui vous permet d’intégrer uniquement les composants nécessaires à votre projet. Sur XBOX/Windows, le SDK est inclus dans l’installation du Microsoft GDK. Le SDK fournit les en-têtes et les binaires des composants suivants :- libHttpClient : abstraction HTTP/WebSocket multiplateforme utilisée par les SDK XBOX et PlayFab. Fournit des API asynchrones, la gestion de la mémoire et une logique de nouvelle tentative. Requis par tous les composants du SDK. Intégration facultative avec XTaskQueue pour la gestion des threads.
- PlayFab Core : fonctionnalités de base pour tous les composants PlayFab. Gère l’authentification, la gestion des entités, la configuration, la télémétrie, la journalisation et la gestion des erreurs.
- PlayFab Services : services partagés pour le LiveOps, l’économie et la progression.
- PlayFab Multiplayer : services de création de lobbies et de matchmaking.
- PlayFab Party : communication vocale, par clavardage textuel et de données multiplateforme à faible latence, avec une intégration facultative d’Azure Cognitive Services pour la reconnaissance vocale, la synthèse vocale, la traduction, et plus encore.
- PlayFab GameSave : stockage et synchronisation des sauvegardes de jeu dans le cloud pour préserver la progression des joueurs entre les appareils et les sessions.