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

> Configura o microfone ou dispositivo de gravação preferencial que o controle de chat usará como entrada de áudio.

Configura o microfone ou dispositivo de gravação preferencial que o controle de chat usará como entrada de áudio.

## Sintaxe

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

### Parâmetros

**`audioDeviceSelectionType`**   [PartyAudioDeviceSelectionType](/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype)

Se [PartyAudioDeviceSelectionType::None](/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype) for especificado, a entrada de áudio será limpa. Se [PartyAudioDeviceSelectionType::SystemDefault](/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype) for especificado, a biblioteca do Party tentará usar o dispositivo de comunicação padrão do sistema. Se [PartyAudioDeviceSelectionType::PlatformUserDefault](/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype) for especificado, a biblioteca do Party tentará usar o dispositivo de comunicação padrão associado a `audioDeviceSelectionContext`. Se [PartyAudioDeviceSelectionType::Manual](/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype) for especificado, a biblioteca do Party tentará usar o dispositivo de comunicação cujo identificador de dispositivo corresponda. Observe que `PartyAudioDeviceSelectionType::Manual` não tem suporte no Android, no iOS nem no macOS.

**`audioDeviceSelectionContext`**   [PartyString](/pt-BR/services/playfab/multiplayer/networking/reference/typedefs)\
*opcional*

Ao usar [PartyAudioDeviceSelectionType::None](/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype) ou [PartyAudioDeviceSelectionType::SystemDefault](/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype), `audioDeviceSelectionContext` será ignorado. Ao usar [PartyAudioDeviceSelectionType::PlatformUserDefault](/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype), `audioDeviceSelectionContext` deve ser o contexto de usuário específico da plataforma, não nulo e não vazio, que o controle de chat deve usar ao selecionar o dispositivo de áudio. Ao usar [PartyAudioDeviceSelectionType::Manual](/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype), `audioDeviceSelectionContext` deve ser o identificador não nulo e não vazio do dispositivo de áudio que o controle de chat deve usar.

**`asyncIdentifier`**   void\*\
*opcional*

Um valor de contexto opcional, definido pelo aplicativo e do tamanho de um ponteiro, que pode ser usado para associar a alteração de estado de conclusão a esta chamada.

### Valor retornado

PartyError

`c_partyErrorSuccess` se a operação assíncrona para definir a entrada de áudio tiver sido iniciada ou um código de erro caso contrário. Se este método falhar, nenhuma alteração de estado relacionada será gerada. A forma legível do código de erro pode ser obtida por meio de [PartyManager::GetErrorMessage()](/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage).

## Comentários

Este método enfileira uma operação assíncrona para configurar o dispositivo de gravação preferencial associado a este controle de chat local. Se o método tiver êxito, um [PartyLocalChatAudioInputChangedStateChange](/pt-BR/services/playfab/multiplayer/networking/reference/structs/partylocalchataudioinputchangedstatechange) será fornecido por [PartyManager::StartProcessingStateChanges()](/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_startprocessingstatechanges) com detalhes sobre o status do dispositivo de entrada, e um [PartySetChatAudioInputCompletedStateChange](/pt-BR/services/playfab/multiplayer/networking/reference/structs/partysetchataudioinputcompletedstatechange) será fornecido na conclusão da operação, indicando êxito ou falha. Após a conclusão, um [PartyLocalChatAudioInputChangedStateChange](/pt-BR/services/playfab/multiplayer/networking/reference/structs/partylocalchataudioinputchangedstatechange) adicional será fornecido sempre que o status do dispositivo de áudio mudar, por exemplo, devido à remoção do dispositivo. <br /><br /> Se o dispositivo especificado não estiver presente, o controle de chat assinará as alterações de dispositivos de áudio e usará o dispositivo quando ele aparecer.   <br /><br /> Ao usar a opção `PlatformUserDefault` na plataforma XBOX, o XBOX User Identifier (XUID) deve ser passado como o valor de `audioDeviceSelectionContext`.

## Requisitos

**Cabeçalho:** Party.h

## Confira também

[PartyLocalChatControl](/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/partylocalchatcontrol)\
[PartyLocalChatControl::GetAudioInput](/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getaudioinput)\
[PartyLocalChatControl::SetAudioOutput](/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_setaudiooutput)


## Related topics

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