> ## 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::SetAudioInput

> Configure le microphone ou périphérique d'enregistrement préféré que le contrôle de clavardage utilisera comme entrée audio.

Configure le microphone ou périphérique d'enregistrement préféré que le contrôle de clavardage utilisera comme entrée audio.

## Syntaxe

```cpp theme={null}
PartyError SetAudioInput(  
    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é, l'entrée 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. Notez que `PartyAudioDeviceSelectionType::Manual` n'est pas pris en charge sur Android, iOS ni macOS.

**`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 l'entrée 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 périphérique d'enregistrement préféré associé à ce contrôle de clavardage local. Si la méthode réussit, un [PartyLocalChatAudioInputChangedStateChange](/fr-CA/services/playfab/multiplayer/networking/reference/structs/partylocalchataudioinputchangedstatechange) 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 d'entrée, et un [PartySetChatAudioInputCompletedStateChange](/fr-CA/services/playfab/multiplayer/networking/reference/structs/partysetchataudioinputcompletedstatechange) 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 [PartyLocalChatAudioInputChangedStateChange](/fr-CA/services/playfab/multiplayer/networking/reference/structs/partylocalchataudioinputchangedstatechange) 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::GetAudioInput](/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getaudioinput)\
[PartyLocalChatControl::SetAudioOutput](/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_setaudiooutput)


## Related topics

- [PartyLocalChatControl::GetAudioInput](/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getaudioinput.md)
- [PartyLocalChatControl::SetAudioOutput](/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_setaudiooutput.md)
- [PartyAudioDeviceSelectionType](/fr-CA/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype.md)
- [PartyLocalChatAudioInputChangedStateChange](/fr-CA/services/playfab/multiplayer/networking/reference/structs/partylocalchataudioinputchangedstatechange.md)
- [PartySetChatAudioInputCompletedStateChange](/fr-CA/services/playfab/multiplayer/networking/reference/structs/partysetchataudioinputcompletedstatechange.md)