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

> Configura os alto-falantes ou o fone de ouvido preferenciais que o controle de chat usará como saída de áudio.

Configura os alto-falantes ou o fone de ouvido preferenciais que o controle de chat usará como saída de áudio.

## Sintaxe

```cpp theme={null}
PartyError SetAudioOutput(  
    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 saída 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 a `audioDeviceSelectionContext`.

**`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 saída 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 os alto-falantes ou o fone de ouvido preferenciais associados a este controle de chat local. Se o método tiver êxito, um [PartyLocalChatAudioOutputChangedStateChange](/pt-BR/services/playfab/multiplayer/networking/reference/structs/partylocalchataudiooutputchangedstatechange) 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 saída, e um [PartySetChatAudioOutputCompletedStateChange](/pt-BR/services/playfab/multiplayer/networking/reference/structs/partysetchataudiooutputcompletedstatechange) será fornecido na conclusão da operação, indicando êxito ou falha. Após a conclusão, um [PartyLocalChatAudioOutputChangedStateChange](/pt-BR/services/playfab/multiplayer/networking/reference/structs/partylocalchataudiooutputchangedstatechange) 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::GetAudioOutput](/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getaudiooutput)\
[PartyLocalChatControl::SetAudioInput](/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_setaudioinput)


## Related topics

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