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

# PartyLocalChatControl::SetAudioOutput

> Configure le haut-parleur ou casque préféré que le contrôle de clavardage utilisera comme sortie audio.

Configure le haut-parleur ou casque préféré que le contrôle de clavardage utilisera comme sortie audio.

## Syntaxe

```cpp theme={null}
PartyError SetAudioOutput(  
    PartyAudioDeviceSelectionType audioDeviceSelectionType,  
    PartyString audioDeviceSelectionContext,  
    void* asyncIdentifier  
)  
```

### Paramètres

**`audioDeviceSelectionType`**   [PartyAudioDeviceSelectionType](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype.md)

Si [PartyAudioDeviceSelectionType::None](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype.md) est spécifié, la sortie audio est effacée. Si [PartyAudioDeviceSelectionType::SystemDefault](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype.md) est spécifié, la bibliothèque Party tente d'utiliser le périphérique de communication par défaut du système. Si [PartyAudioDeviceSelectionType::PlatformUserDefault](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype.md) est spécifié, la bibliothèque Party tente d'utiliser le périphérique de communication par défaut associé à `audioDeviceSelectionContext`. Si [PartyAudioDeviceSelectionType::Manual](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype.md) est spécifié, la bibliothèque Party tente d'utiliser le périphérique de communication dont l'identificateur correspond à `audioDeviceSelectionContext`.

**`audioDeviceSelectionContext`**   [PartyString](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/typedefs.md)\
*optional*

Avec [PartyAudioDeviceSelectionType::None](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype.md) ou [PartyAudioDeviceSelectionType::SystemDefault](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype.md), `audioDeviceSelectionContext` est ignoré. Avec [PartyAudioDeviceSelectionType::PlatformUserDefault](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype.md), `audioDeviceSelectionContext` doit être le contexte utilisateur propre à la plateforme, non null et non vide, que le contrôle de clavardage doit utiliser lors de la sélection du périphérique audio. Avec [PartyAudioDeviceSelectionType::Manual](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype.md), `audioDeviceSelectionContext` doit être l'identificateur, non null et non vide, du périphérique audio que le contrôle de clavardage doit utiliser.

**`asyncIdentifier`**   void\*\
*optional*

Une valeur de contexte facultative de la taille d'un pointeur, définie par l'application, qui peut être utilisée pour associer le changement d'état de fin à cet appel.

### Valeur de retour

PartyError

`c_partyErrorSuccess` si l'opération asynchrone de définition de la sortie audio a commencé; sinon, un code d'erreur. Si cette méthode échoue, aucun changement d'état associé n'est généré. La forme lisible du code d'erreur peut être obtenue au moyen de [PartyManager::GetErrorMessage()](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage.md).

## Remarques

Cette méthode met en file d'attente une opération asynchrone pour configurer le haut-parleur ou casque préféré associé à ce contrôle de clavardage local. Si la méthode réussit, un [PartyLocalChatAudioOutputChangedStateChange](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/structs/partylocalchataudiooutputchangedstatechange.md) est fourni par [PartyManager::StartProcessingStateChanges()](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_startprocessingstatechanges.md) avec des détails sur l'état du périphérique de sortie, et un [PartySetChatAudioOutputCompletedStateChange](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/structs/partysetchataudiooutputcompletedstatechange.md) est fourni à la fin de l'opération pour indiquer la réussite ou l'échec. Après la fin de l'opération, un [PartyLocalChatAudioOutputChangedStateChange](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/structs/partylocalchataudiooutputchangedstatechange.md) supplémentaire est fourni chaque fois que l'état du périphérique audio change, par exemple en raison de la suppression d'un périphérique. \
\
 Si le périphérique spécifié n'est pas présent, le contrôle de clavardage s'abonne aux modifications des périphériques audio et utilise le périphérique lorsqu'il apparaît.   \
\
 Lors de l'utilisation de l'option `PlatformUserDefault` sur la plateforme XBOX, l'identificateur d'utilisateur XBOX (XUID) doit être transmis comme valeur de `audioDeviceSelectionContext`.

## Configuration requise

**En-tête :** Party.h

## Voir aussi

[PartyLocalChatControl](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/partylocalchatcontrol.md)\
[PartyLocalChatControl::GetAudioOutput](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getaudiooutput.md)\
[PartyLocalChatControl::SetAudioInput](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_setaudioinput.md)


## Related topics

- [PartyLocalChatControl::GetAudioOutput](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getaudiooutput.md)
- [PartyLocalChatControl::SetAudioInput](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_setaudioinput.md)
- [PartyLocalChatAudioOutputChangedStateChange](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/structs/partylocalchataudiooutputchangedstatechange.md)
- [PartySetChatAudioOutputCompletedStateChange](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/structs/partysetchataudiooutputcompletedstatechange.md)
- [PartyAudioDeviceSelectionType](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype.md)