Skip to main content
Avec PlayFab Party, vous pouvez facilement ajouter des communications vocales et textuelles à votre jeu. La conversation PlayFab Party est :
  • Flexible : vous offre un contrôle total sur la manière dont vous souhaitez que vos joueurs communiquent.
  • Puissante : utilise l’accélération matérielle des codecs sur les plateformes prises en charge.
  • Accessible : optimisées par Azure Cognitive Services, les fonctionnalités de reconnaissance vocale, de synthèse vocale et de traduction sont intégrées et faciles à activer.
  • Efficace : l’intégration étroite de votre système de conversation avec votre couche réseau signifie que les données vocales sont envoyées là où elles doivent aller de la manière la plus efficace possible.

​
Notions de base de la conversation

Pour ajouter des communications vocales et textuelles à votre jeu, vous devez d’abord créer un objet PartyLocalChatControl. Cet objet PartyLocalChatControl sert d’objet de gestion pour les opérations de conversation liées à un utilisateur local spécifique, ce qui vous permet de choisir le périphérique d’entrée et de sortie, l’état de sourdine et les préférences d’accessibilité. Chaque utilisateur local ne peut avoir qu’un seul contrôle de conversation. Pour qu’un contrôle de conversation local puisse communiquer avec un autre contrôle de conversation, les conditions suivantes doivent être remplies :
  1. Les deux contrôles de conversation doivent se trouver sur le même réseau.
  2. Les autorisations de conversation entre les deux contrôles de conversation doivent permettre la circulation de la communication audio et/ou textuelle.
Une fois votre contrôle de conversation local en main, vous êtes prêt à le connecter à un réseau en appelant PartyNetwork::ConnectChatControl(). Lors de la connexion, les autres appareils du réseau sont informés que votre contrôle de conversation a rejoint le réseau par un changement d’état PartyChatControlJoinedNetworkStateChange. Vous recevrez également un PartyChatControlJoinedNetworkStateChange pour chaque autre contrôle de conversation déjà présent sur le réseau et pourrez immédiatement communiquer avec eux.

​
Entrées et sorties audio

Party vous permet de choisir le ou les périphériques audio qui seront utilisés par votre contrôle de conversation avec les méthodes PartyLocalChatControl::SetAudioInput() et PartyLocalChatControl::SetAudioOutput(). Utilisez l’énumération PartyAudioDeviceSelectionType pour modifier le comportement de ces méthodes :

​
PartyAudioDeviceSelectionType::None

Lorsque ce type de sélection de périphérique audio est choisi, le contrôle de conversation n’utilise aucun périphérique audio. Ce type de sélection de périphérique audio est la valeur par défaut.

​
PartyAudioDeviceSelectionType::SystemDefault

Lorsque ce type de sélection de périphérique audio est choisi, le contrôle de conversation tente d’utiliser le périphérique de communication par défaut du système. Sous Windows, le joueur peut changer ce périphérique à tout moment via le panneau de configuration Son de Windows, et Party réagit automatiquement à ces changements. Ce type de sélection n’est pas pris en charge sur XBOX One et n’est généralement pas recommandé si plusieurs utilisateurs locaux participent simultanément à la conversation.

​
PartyAudioDeviceSelectionType::PlatformUserDefault

Lorsque ce type de sélection de périphérique audio est choisi, PartyLocalChatControl::SetAudioInput() et PartyLocalChatControl::SetAudioOutput() exigent que le paramètre audioDeviceSelectionContext soit défini sur un ID d’utilisateur de la plateforme. Party tente alors d’utiliser le périphérique de communication par défaut de la plateforme associé à cet utilisateur. Sur XBOX One, audioDeviceSelectionContext doit être l’ID d’utilisateur XBOX associé à l’utilisateur actuellement lié au contrôle de conversation.

​
PartyAudioDeviceSelectionType::Manual

Lorsque ce type de sélection de périphérique audio est choisi, PartyLocalChatControl::SetAudioInput() et PartyLocalChatControl::SetAudioOutput() utilisent le paramètre audioDeviceSelectionContext comme identificateur de périphérique audio valide et tentent d’utiliser tout périphérique correspondant à cet identificateur. Consultez le tableau suivant pour connaître les types d’identificateurs pris en charge par PlayFab Party :
Nous vous recommandons vivement d’utiliser PartyAudioDeviceSelectionType::PlatformUserDefault sur XBOX One et PartyAudioDeviceSelectionType::SystemDefault sur les plateformes Windows.

​
Autorisations de conversation et sourdine

Party vous offre un contrôle précis sur la manière dont vos joueurs peuvent communiquer entre eux. Plutôt que de spécifier des équipes ou des canaux, Party exige de définir explicitement les autorisations entre chaque paire de contrôles de conversation. Pour en savoir plus sur les autorisations de conversation, la sourdine et la création de scénarios de conversation courants, consultez la page Vue d’ensemble des autorisations de conversation.

​
Conversation textuelle, traduction et modération

Party vous permet également d’envoyer et de recevoir des messages de conversation textuelle vers et depuis d’autres contrôles de conversation. Bien que la méthode PartyLocalChatControl::SendText() vous permette d’envoyer des messages texte à un nombre arbitraire de contrôles de conversation, vous pouvez être assuré que seuls les contrôles de conversation disposant de l’autorisation de conversation PartyChatPermissionOptions::ReceiveText appropriée reçoivent les messages. La traduction de la conversation textuelle peut également être activée en appelant PartyLocalChatControl::SetTextChatOptions(). En définissant l’option PartyTextChatOptions::TranslateToLocalLanguage, Party traduit les messages texte entrants dans la langue du contrôle de conversation local. La langue du contrôle de conversation peut éventuellement être configurée lors de sa création et peut être consultée en appelant PartyLocalChatControl::GetLanguage(). La traduction est également appliquée aux transcriptions entrantes de reconnaissance vocale. La modération du texte est également disponible pour la conversation textuelle. Pour en savoir plus sur cette fonctionnalité, consultez la page Utilisation de la modération du texte.

​
Conversation accessible

Optimisé par Azure Speech Services, Party peut transcrire la conversation vocale des joueurs et synthétiser la parole à partir de texte. Cette fonctionnalité a plusieurs utilisations, mais a été principalement conçue comme une aide à l’accessibilité. Nous vous recommandons de lier l’activation de cette fonctionnalité à un paramètre d’options d’ergonomie du joueur. Pour plus d’informations sur l’utilisation des fonctionnalités d’accessibilité fournies par Party, consultez les recommandations relatives à la synthèse vocale et les recommandations relatives à la reconnaissance vocale.

​
Suppression du bruit de l’entrée audio

Party vous permet de supprimer le bruit de fond de l’audio capturé par le microphone avant sa transmission aux contrôles de conversation distants. Cela peut améliorer considérablement la qualité audio de la voix de vos joueurs. Pour plus d’informations sur l’activation de la suppression du bruit, consultez la page Utilisation de la suppression du bruit.
La suppression du bruit n’est actuellement disponible que sur iOS et Android.

​
Étapes suivantes

Last modified on October 6, 2026