Azure PlayFab Party
Utilisez cette rubrique pour comprendre comment utiliser PlayFab Party avec le Microsoft Game Development Kit (GDK). PlayFab Party simplifie l’ajout du clavardage à faible latence et de la communication de données à votre jeu d’une manière souple, inclusive et sécurisée. Party est idéal pour les implémentations multijoueurs lorsqu’un serveur dédié hébergé dans le nuage n’est pas souhaité (on parle parfois de jeux pair à pair ou de jeux P2P). Party alimente les communications vocales et textuelles pour les expériences sociales au sein de votre application (par exemple, les escouades en jeu ou les salons d’après-partie), même si vous utilisez un serveur infonuagique comme hôte du jeu. Party est le successeur, dans le Microsoft Game Development Kit (GDK), de l’API Secure Sockets de l’ERA de la XBOX One. Party utilise Azure Cognitive Services pour transcrire le clavardage vocal des utilisateurs et synthétiser le texte en parole, une fonctionnalité conçue principalement comme aide à l’accessibilité. L’utilisation typique du clavardage vocal PlayFab Party est facturée à la minute. Jusqu’à 10 % de ces minutes vocales peuvent utiliser gratuitement la transcription et la synthèse. Nous recommandons d’associer l’activation de cette fonctionnalité à un paramètre utilisateur d’options d’ergonomie.[!NOTE] Party traduit également le clavardage en temps réel. Dans le jumelage anonyme et les jeux compétitifs internationaux, ces capacités de transcription et de traduction offrent une expérience multijoueur plus engageante.Un objectif clé de PlayFab Party (et de nos autres services multijoueurs) est de faciliter une infrastructure multijoueur interopérable et le jeu entre réseaux. Vérifiez que vos expériences multijoueurs sont conformes aux stratégies de plateforme pertinentes en matière de multijoueur et d’activité des utilisateurs entre réseaux.
Fonctionnalités de PlayFab Party
- Chiffrement et authentification : Party authentifie les appareils des utilisateurs au moyen de leur identité d’utilisateur PlayFab et chiffre les données avec un protocole de type DTLS.
- Mise en réseau par datagrammes d’appareil à appareil : Au cœur de Party se trouvent des relais hébergés mondialement dans le nuage Azure. Les appareils des utilisateurs utilisent ces relais pour créer des réseaux Party et s’envoyer des données de jeu. Le système de mise en réseau Party comprend des fonctionnalités de transport configurables, comme les nouvelles tentatives automatiques en cas de perte de paquets.
- Clavardage vocal et textuel : Les appareils des utilisateurs peuvent lier des périphériques audio aux réseaux Party pour le clavardage vocal en temps réel. Party prend également en charge les messages de clavardage textuel entre utilisateurs.
- Reconnaissance vocale et synthèse vocale : Party peut transcrire le clavardage vocal des utilisateurs et synthétiser des énoncés pour les messages textuels. Cette fonctionnalité a plusieurs usages, mais a été conçue principalement comme aide à l’accessibilité.
- Traduction en temps réel : Party peut comprendre et synthétiser des traductions en temps réel du clavardage vocal et textuel des utilisateurs.
Considérations relatives au Microsoft Game Development Kit (GDK)
Exigences de XBOX services
La communication entre utilisateurs pour les titres XBOX services doit respecter plusieurs exigences relatives à la sécurité des utilisateurs. L’utilisation de PlayFab Party avec le plugiciel XBOX services de PlayFab Party garantit que votre titre respecte toutes les exigences de communication et de sécurité de XBOX services.[!NOTE] Une exigence XBOX (XR) est une exigence qu’un jeu doit respecter avant de pouvoir être publié sur les plateformes XBOX.
- XR-015 : Gestion de la communication entre joueurs.
- XR-045 : XBOX services et privilèges de compte. Le plugiciel XBOX services n’applique que la partie XPRIVILEGE_COMMUNICATIONS. Si votre titre utilise d’autres fonctionnalités XBOX services, vous devez effectuer les vérifications de privilèges nécessaires.
- XR-072 : Prise en charge de la voix.
- Jeu entre réseaux : PlayFab Party n’applique que la partie Jeu entre réseaux qui nécessite un serveur. Votre titre est responsable des vérifications de privilèges nécessaires et de l’interaction avec XBOX services.
- XR-064 : Sessions de jeu joignables et jeu en ligne
- XR-067 : Maintien des interactions « Joueurs récents »
Initialisation du réseau
PlayFab Party ne gère pas automatiquement l’initialisation du réseau pour les titres du Microsoft Game Development Kit (GDK). Attendez que le réseau soit initialisé avant d’appeler PlayFab Party. Les API Party échouent tant que le réseau n’est pas initialisé.Suspension et reprise
Vous devez vous inscrire aux événements de suspension et de reprise au moyen deRegisterAppStateChangeNotification. Lors de la suspension, nettoyez Party avec PartyManager::Cleanup(). Lors de la reprise, vous devez de nouveau attendre l’initialisation du réseau avant d’appeler PartyManager::Initialize(). Les API Party échouent si vous tentez de les utiliser au cours d’un cycle de suspension/reprise.
L’exécution de PartyManager::Cleanup() peut prendre quelques centaines de millisecondes. Nous recommandons de nettoyer Party en parallèle avec vos autres opérations de suspension afin d’éviter les délais d’expiration de suspension. Si vous appelez Partymanager::Cleanup() de façon asynchrone, assurez-vous de bloquer la notification de suspension jusqu’à ce que le nettoyage de Party se termine.
Informations sur la tarification
PlayFab Party est gratuit pour le Microsoft Game Development Kit (GDK) lorsque vous utilisez des identités XBOX services. Pour plus d’informations sur la tarification et la facturation, consultez la FAQ du programme gratuit XBOX services.Configuration de votre titre dans le portail PlayFab
- Accédez à https://developer.playfab.com/, puis créez un compte.
- Créez un studio PlayFab et un ID de titre à l’aide de votre nouveau compte.
- Accédez au titre que vous venez de créer, sélectionnez la section Multiplayer, puis sélectionnez l’onglet Party (Preview).
- Sélectionnez Enable, puis entrez le code d’accès XBOX Live. Party est activé après quelques instants.
- Dans l’onglet API Features, copiez votre ID de titre PlayFab et votre ICD d’entité.
- Ajoutez l’ID de titre et l’ICD d’entité à la fonction d’initialisation de l’API PlayFab Party du client. Vous pouvez maintenant utiliser PlayFab Party dans votre titre du Microsoft Game Development Kit (GDK).
Ajout de la bibliothèque PlayFab Party à votre projet du Microsoft Game Development Kit (GDK) à l’aide de Visual Studio
- Cliquez avec le bouton droit sur votre projet dans l’Explorateur de solutions de Visual Studio, puis sélectionnez Propriétés.
- Dans Propriétés de configuration, accédez à la section XBOX One.
- Sélectionnez la liste déroulante Gaming Extension Libraries, puis ajoutez une référence à PlayFab Party et à XBOX Live Helper.
[!NOTE] Les bibliothèques sont installées à un emplacement par défaut sous Program Files (x86)\Microsoft GDK[Version]\GRDK\ExtensionLibraries\PlayFab.Party.Cpp\Redist\x64 (octobre 2024 ou version ultérieure) -ou- Program Files (x86)\Microsoft GDK[Version]\GRDK\ExtensionLibraries\PlayFab.Party.Cpp\Redist\CommonConfiguration\neutral (juin 2024 ou version antérieure).