Pular para o conteúdo principal
Configura os alto-falantes ou o fone de ouvido preferenciais que o controle de chat usará como saída de áudio.

Sintaxe

Parâmetros

audioDeviceSelectionType   PartyAudioDeviceSelectionType Se PartyAudioDeviceSelectionType::None for especificado, a saída de áudio será limpa. Se PartyAudioDeviceSelectionType::SystemDefault for especificado, a biblioteca do Party tentará usar o dispositivo de comunicação padrão do sistema. Se PartyAudioDeviceSelectionType::PlatformUserDefault for especificado, a biblioteca do Party tentará usar o dispositivo de comunicação padrão associado a audioDeviceSelectionContext. Se PartyAudioDeviceSelectionType::Manual for especificado, a biblioteca do Party tentará usar o dispositivo de comunicação cujo identificador de dispositivo corresponda a audioDeviceSelectionContext. audioDeviceSelectionContext   PartyString
opcional
Ao usar PartyAudioDeviceSelectionType::None ou PartyAudioDeviceSelectionType::SystemDefault, audioDeviceSelectionContext será ignorado. Ao usar PartyAudioDeviceSelectionType::PlatformUserDefault, 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, 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().

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 será fornecido por PartyManager::StartProcessingStateChanges() com detalhes sobre o status do dispositivo de saída, e um PartySetChatAudioOutputCompletedStateChange será fornecido na conclusão da operação, indicando êxito ou falha. Após a conclusão, um PartyLocalChatAudioOutputChangedStateChange 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
PartyLocalChatControl::GetAudioOutput
PartyLocalChatControl::SetAudioInput
Última modificação em 8 de outubro de 2026