Azure PlayFab Party
Utilisez cette rubrique pour comprendre comment utiliser PlayFab Party avec le Microsoft Game Development Kit (GDK). PlayFab Party simplifie l’ajout de la conversation à faible latence et de la communication de données à votre jeu, de manière flexible, inclusive et sécurisée. Party est idéal pour les implémentations multijoueurs lorsqu’un serveur dédié hébergé dans le cloud n’est pas souhaité (on parle parfois de jeux pair à pair ou de jeux P2P). Party assure 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 cloud comme hôte du jeu. Party est le successeur, dans le Microsoft Game Development Kit (GDK), de l’API Secure Sockets de l’ERA XBOX One. Party utilise Azure Cognitive Services pour transcrire la conversation vocale des utilisateurs et synthétiser du texte en parole, ce qui a été principalement conçu comme une aide à l’accessibilité. L’utilisation typique de la conversation vocale PlayFab Party est facturée à la minute. Jusqu’à 10 % de ces minutes vocales peuvent utiliser gratuitement la transcription et la synthèse. Nous vous recommandons de lier l’activation de cette fonctionnalité à un paramètre utilisateur d’options d’ergonomie.[!NOTE] Party traduit également la conversation en temps réel. Dans le matchmaking anonyme et les jeux compétitifs internationaux, ces capacités de transcription et de traduction offrent une expérience multijoueur plus engageante.L’un des principaux objectifs 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 applicables 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 à l’aide de leur identité d’utilisateur PlayFab et chiffre les données avec un protocole de type DTLS.
- Mise en réseau de datagrammes d’appareil à appareil : au cœur de Party se trouvent des relais hébergés dans le monde entier sur le cloud 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 inclut des fonctionnalités de transport configurables, telles que les nouvelles tentatives automatiques en cas de perte de paquets.
- Conversation vocale et textuelle : les appareils des utilisateurs peuvent lier des périphériques audio aux réseaux Party pour la conversation vocale en temps réel. Party prend également en charge les messages de conversation textuelle entre utilisateurs.
- Reconnaissance vocale et synthèse vocale : Party peut transcrire la conversation vocale des utilisateurs et synthétiser des énoncés pour les messages texte. Cette fonctionnalité a plusieurs usages, mais elle a été principalement conçue comme une aide à l’accessibilité.
- Traduction en temps réel : Party peut comprendre et synthétiser des traductions en temps réel de la conversation vocale et textuelle des utilisateurs.
Considérations relatives au Microsoft Game Development Kit (GDK)
Exigences relatives à XBOX services
La communication entre utilisateurs pour les titres XBOX services doit satisfaire plusieurs exigences relatives à la sécurité des utilisateurs. L’utilisation de PlayFab Party avec le plug-in PlayFab Party XBOX services garantit que votre titre satisfait à toutes les exigences de communication et de sécurité de XBOX services.[!NOTE] Une exigence XBOX (XR, XBOX Requirement) est une exigence qu’un jeu doit satisfaire 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 plug-in XBOX services applique uniquement 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 applique uniquement 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 rejoignables 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 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 viaRegisterAppStateChangeNotification. Lors de la suspension, nettoyez Party avec PartyManager::Cleanup(). Lors de la reprise, vous devez à nouveau attendre l’initialisation du réseau avant d’appeler PartyManager::Initialize(). Les API Party échouent si vous tentez de les utiliser au-delà d’un cycle de suspension/reprise.
L’exécution de PartyManager::Cleanup() peut prendre quelques centaines de millisecondes. Nous vous recommandons de nettoyer Party en parallèle de vos autres opérations de suspension afin d’éviter les dépassements du délai de suspension. Si vous appelez Partymanager::Cleanup() de manière asynchrone, veillez à bloquer la notification de suspension jusqu’au retour du nettoyage de Party.
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 le 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é au bout de quelques instants.
- Sous l’onglet API Features, copiez votre ID de titre PlayFab et l’ICD d’entité.
- Ajoutez l’ID de titre et l’ICD d’entité à la fonction d’initialisation de l’API PlayFab Party côté client. Vous pouvez maintenant utiliser PlayFab Party dans votre titre Microsoft Game Development Kit (GDK).
Ajout de la bibliothèque PlayFab Party à votre projet 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 dans 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).