> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Comprendre le fonctionnement de la conversation PlayFab Party

> Vue d'ensemble de la conversation vocale et textuelle PlayFab Party, couvrant PartyLocalChatControl, les réseaux, les codecs matériels et les fonctionnalités intégrées de reconnaissance vocale et de traduction.

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](/fr/services/playfab/community/voice-communications/concepts-chat-permissions-and-muting) 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 :

| **Plateforme** | **Élément à utiliser** |
| :- | :- |
| Windows 10 | [`IMMDevice`](https://learn.microsoft.com/en-us/windows/win32/api/mmdeviceapi/nf-mmdeviceapi-immdevice-getid) ou [`Windows.Media.Devices`](https://learn.microsoft.com/en-us/uwp/api/windows.media.devices.mediadevice) |
| XBOX | Consultez la documentation du GDK XBOX |

<Note>
  Nous vous recommandons vivement d'utiliser `PartyAudioDeviceSelectionType::PlatformUserDefault` sur XBOX One et `PartyAudioDeviceSelectionType::SystemDefault` sur les plateformes Windows.
</Note>

## 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](/fr/services/playfab/community/voice-communications/concepts-chat-permissions-and-muting).

## 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](/fr/services/playfab/community/voice-communications/concepts-text-moderation).

## 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](/fr/services/playfab/community/voice-communications/party-text-to-speech-ux-guidelines) et les [recommandations relatives à la reconnaissance vocale](/fr/services/playfab/community/voice-communications/party-speech-to-text-ux-guidelines).

## 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](/fr/services/playfab/community/voice-communications/concepts-noise-suppression).

<Note>
  La suppression du bruit n'est actuellement disponible que sur iOS et Android.
</Note>

## Étapes suivantes

* [En savoir plus sur les autorisations de conversation et la sourdine dans PlayFab Party](/fr/services/playfab/community/voice-communications/concepts-chat-permissions-and-muting)


## Related topics

- [Notas de la versión de PlayFab Party](/es/services/playfab/multiplayer/networking/release-notes.md)
- [Guide BVT de certification pour console](/fr/publishing/game-publishing/concepts/certification/certification-console-bvt-guide.md)
- [Directrices de experiencia de usuario de conversión de voz en texto y visualización de texto de PlayFab Party](/es/services/playfab/community/voice-communications/party-speech-to-text-ux-guidelines.md)
- [Étiquettes de fonctionnalités d'accessibilité](/fr-CA/build/game-principles/accessibility/accessibility-feature-tags.md)
- [Notes de version de PlayFab Party](/fr-CA/services/playfab/multiplayer/networking/release-notes.md)