Skip to main content
Avec PlayFab Party, vous pouvez facilement ajouter la communication vocale et textuelle à votre jeu. Le clavardage de PlayFab Party est :
  • Flexible : vous donne un contrôle total sur la façon dont vous voulez que vos joueurs communiquent.
  • Puissant : utilise l’accélération matérielle des codecs sur les plateformes prises en charge.
  • Accessible : propulsées par Azure Cognitive Services, les fonctionnalités de reconnaissance vocale (voix en texte), de synthèse vocale (texte en voix) et de traduction sont intégrées et faciles à activer.
  • Efficace : l’intégration étroite de votre système de clavardage à votre couche réseau permet d’envoyer les données vocales là où elles doivent aller de la manière la plus efficace possible.

​
Notions de base du clavardage

Pour ajouter la communication vocale et textuelle à votre jeu, vous devez d’abord créer un objet PartyLocalChatControl. Cet objet PartyLocalChatControl agira comme objet de gestion pour les opérations de clavardage liées à un utilisateur local précis, 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 peut avoir au plus un contrôle de clavardage. Pour qu’un contrôle de clavardage local puisse communiquer avec un autre contrôle de clavardage, les exigences suivantes doivent être respectées :
  1. Les deux contrôles de clavardage doivent se trouver dans le même réseau.
  2. Les autorisations de clavardage entre les deux contrôles de clavardage doivent permettre la circulation de la communication audio ou textuelle, ou les deux.
Une fois votre contrôle de clavardage 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 seront avisés que votre contrôle de clavardage a rejoint le réseau au moyen d’un changement d’état PartyChatControlJoinedNetworkStateChange. Vous recevrez également un PartyChatControlJoinedNetworkStateChange pour chacun des autres contrôles de clavardage déjà présents dans 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 clavardage 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 clavardage n’utilise aucun périphérique audio. Ce type de sélection de périphérique audio est le type par défaut.

​
PartyAudioDeviceSelectionType::SystemDefault

Lorsque ce type de sélection de périphérique audio est choisi, le contrôle de clavardage 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 en tout temps au moyen du panneau de configuration Son de Windows, et Party réagira 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 plus d’un utilisateur local participe simultanément au clavardage.

​
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 clavardage.

​
PartyAudioDeviceSelectionType::Manual

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

​
Autorisations de clavardage et sourdine

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

​
Clavardage textuel, traduction et modération

Party vous permet également d’envoyer et de recevoir des messages textuels de clavardage à partir d’autres contrôles de clavardage. Bien que la méthode PartyLocalChatControl::SendText() vous permette d’envoyer des messages textuels à un nombre arbitraire de contrôles de clavardage, soyez assuré que seuls les contrôles de clavardage disposant de l’autorisation de clavardage PartyChatPermissionOptions::ReceiveText appropriée recevront les messages. La traduction du clavardage textuel peut également être activée en appelant PartyLocalChatControl::SetTextChatOptions(). En définissant l’option PartyTextChatOptions::TranslateToLocalLanguage, Party traduira les messages textuels entrants dans la langue du contrôle de clavardage local. La langue du contrôle de clavardage peut éventuellement être configurée lors de la création du contrôle de clavardage et peut être consultée en appelant PartyLocalChatControl::GetLanguage(). La traduction sera également appliquée à la transcription de la reconnaissance vocale entrante. La modération de texte est également offerte pour le clavardage textuel. Pour en savoir plus sur cette fonctionnalité, consultez la page Utiliser la modération de texte.

​
Clavardage accessible

Propulsé par Azure Speech Services, Party peut transcrire le clavardage vocal des joueurs et synthétiser de la parole à partir de texte. Cette fonctionnalité a plusieurs usages, mais elle a été conçue principalement comme aide à l’accessibilité. Nous recommandons de lier l’activation de cette capacité à un paramètre d’options d’ergonomie du joueur. Pour plus d’information sur l’utilisation des fonctionnalités d’accessibilité fournies par Party, consultez les lignes directrices sur la synthèse vocale et les lignes directrices sur la reconnaissance vocale.

​
Suppression du bruit de l’entrée audio

Party vous permet de supprimer le bruit de fond dans l’audio capté par le microphone avant sa transmission aux contrôles de clavardage distants. Cela peut améliorer considérablement la qualité de l’audio vocal de vos joueurs. Pour plus d’information sur la façon d’activer la suppression du bruit, consultez la page Utiliser la suppression du bruit.
La suppression du bruit est actuellement offerte uniquement sur iOS et Android.

​
Étapes suivantes

Last modified on October 6, 2026