> ## 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.

# 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](/fr-CA/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype)

Si [PartyAudioDeviceSelectionType::None](/fr-CA/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype) est spécifié, la sortie audio est effacée. Si [PartyAudioDeviceSelectionType::SystemDefault](/fr-CA/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype) 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](/fr-CA/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype) est spécifié, la bibliothèque Party tente d'utiliser le périphérique de communication par défaut associé à `audioDeviceSelectionContext`. Si [PartyAudioDeviceSelectionType::Manual](/fr-CA/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype) est spécifié, la bibliothèque Party tente d'utiliser le périphérique de communication dont l'identificateur correspond à `audioDeviceSelectionContext`.

**`audioDeviceSelectionContext`**   [PartyString](/fr-CA/services/playfab/multiplayer/networking/reference/typedefs)\
*optional*

Avec [PartyAudioDeviceSelectionType::None](/fr-CA/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype) ou [PartyAudioDeviceSelectionType::SystemDefault](/fr-CA/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype), `audioDeviceSelectionContext` est ignoré. Avec [PartyAudioDeviceSelectionType::PlatformUserDefault](/fr-CA/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype), `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](/fr-CA/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype), `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()](/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage).

## 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](/fr-CA/services/playfab/multiplayer/networking/reference/structs/partylocalchataudiooutputchangedstatechange) est fourni par [PartyManager::StartProcessingStateChanges()](/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_startprocessingstatechanges) avec des détails sur l'état du périphérique de sortie, et un [PartySetChatAudioOutputCompletedStateChange](/fr-CA/services/playfab/multiplayer/networking/reference/structs/partysetchataudiooutputcompletedstatechange) 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](/fr-CA/services/playfab/multiplayer/networking/reference/structs/partylocalchataudiooutputchangedstatechange) 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. <br /><br /> 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.   <br /><br /> 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](/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/partylocalchatcontrol)\
[PartyLocalChatControl::GetAudioOutput](/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getaudiooutput)\
[PartyLocalChatControl::SetAudioInput](/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_setaudioinput)


## Related topics

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