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

# PartyChatControl::GetAudioManipulationVoiceStream

> 检索与此聊天控件关联的音频操作语音流。

检索与此聊天控件关联的音频操作语音流。

## 语法

```cpp theme={null}
PartyError GetAudioManipulationVoiceStream(  
    PartyAudioManipulationSourceStream** sourceStream  
)  
```

### 参数

**`sourceStream`**   [PartyAudioManipulationSourceStream\*\*](/services/playfab/multiplayer/networking/reference/classes/PartyAudioManipulationSourceStream/partyaudiomanipulationsourcestream)
*由库分配的输出*

源流。

### 返回值

PartyError

如果调用成功,则返回 `c_partyErrorSuccess`;否则返回错误代码。可以通过 [PartyManager::GetErrorMessage()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage) 检索错误代码的人类可读形式。

## 备注

在本地聊天控件中,流表示本地音频输入检测到的语音音频。此流提供的音频已通过语音活动检测 (VAD) 和自动增益控制 (AGC) 进行了预处理。仅在检测到语音活动时才提供音频。通常,应用通过 PartyAudioManipulationSourceStream::GetNextBuffer() 从此流检索音频,使用应用逻辑处理音频,然后将音频提交回库。通过 PartyLocalChatControl::GetAudioManipulationCaptureStream() 检索语音接收器流,然后通过 [PartyAudioManipulationSinkStream::SubmitBuffer()](/services/playfab/multiplayer/networking/reference/classes/PartyAudioManipulationSinkStream/methods/partyaudiomanipulationsinkstream_submitbuffer) 提交缓冲区,将音频提交回库。<br /><br /> 通过 [PartyLocalChatControl::SynthesizeTextToSpeech()](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_synthesizetexttospeech) 生成的类型为 [PartySynthesizeTextToSpeechType::VoiceChat](/services/playfab/multiplayer/networking/reference/enums/partysynthesizetexttospeechtype) 的音频通过此源流提供,因为此类音频充当关联用户的语音。<br /><br /> 通过此流检索的音频尚未通过语音转文本进行语音聊天转录。如果通过 [PartyLocalChatControl::SetTranscriptionOptions](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions) 配置的转录选项指示应转录与接收器的聊天控件关联的音频,则通过 PartyAudioManipulationSinkStream::SubmitBuffer() 提交到接收器流的音频会被转录。<br /><br /> 在远程聊天控件中,流表示聊天控件的传入语音音频。通常,应用通过 PartyAudioManipulationSourceStream::GetNextBuffer() 从与所有远程聊天控件关联的语音流中检索音频,将每个缓冲区处理并混合到单个音频流中,然后提交混合流,以便由每个适当的接收器流呈现。可以通过 PartyLocalChatControl::GetAudioManipulationRenderStream() 检索每个呈现流。

## 要求

\*\*头文件:\*\*Party.h

## 另请参阅

[PartyChatControl](/services/playfab/multiplayer/networking/reference/classes/PartyChatControl/partychatcontrol)


## Related topics

- [PartyChatControl::ConfigureAudioManipulationVoiceStream](/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyChatControl/methods/partychatcontrol_configureaudiomanipulationvoicestream.md)
- [PartyConfigureAudioManipulationVoiceStreamCompletedStateChange](/zh-CN/services/playfab/multiplayer/networking/reference/structs/partyconfigureaudiomanipulationvoicestreamcompletedstatechange.md)
- [使用实时音频操作应用自定义语音效果](/zh-CN/services/playfab/community/voice-communications/concepts-realtime-audio-manipulation.md)
- [PartyLocalChatControl::GetAudioManipulationRenderStream](/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getaudiomanipulationrenderstream.md)
- [PartyLocalChatControl::GetAudioManipulationCaptureStream](/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getaudiomanipulationcapturestream.md)