> ## 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::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](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype.md)

Se [PartyAudioDeviceSelectionType::None](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype.md) for especificado, a entrada de áudio será limpa. Se [PartyAudioDeviceSelectionType::SystemDefault](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype.md) for especificado, a biblioteca do Party tentará usar o dispositivo de comunicação padrão do sistema. Se [PartyAudioDeviceSelectionType::PlatformUserDefault](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype.md) for especificado, a biblioteca do Party tentará usar o dispositivo de comunicação padrão associado a `audioDeviceSelectionContext`. Se [PartyAudioDeviceSelectionType::Manual](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype.md) 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](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/typedefs.md)\
*opcional*

Ao usar [PartyAudioDeviceSelectionType::None](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype.md) ou [PartyAudioDeviceSelectionType::SystemDefault](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype.md), `audioDeviceSelectionContext` será ignorado. Ao usar [PartyAudioDeviceSelectionType::PlatformUserDefault](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype.md), `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](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype.md), `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()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage.md).

## 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](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/structs/partylocalchataudioinputchangedstatechange.md) será fornecido por [PartyManager::StartProcessingStateChanges()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_startprocessingstatechanges.md) com detalhes sobre o status do dispositivo de entrada, e um [PartySetChatAudioInputCompletedStateChange](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/structs/partysetchataudioinputcompletedstatechange.md) será fornecido na conclusão da operação, indicando êxito ou falha. Após a conclusão, um [PartyLocalChatAudioInputChangedStateChange](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/structs/partylocalchataudioinputchangedstatechange.md) adicional será fornecido sempre que o status do dispositivo de áudio mudar, por exemplo, devido à remoção do dispositivo. \
\
 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.   \
\
 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](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/partylocalchatcontrol.md)\
[PartyLocalChatControl::GetAudioInput](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getaudioinput.md)\
[PartyLocalChatControl::SetAudioOutput](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_setaudiooutput.md)


## Related topics

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