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

# PartyChatControl::GetAudioManipulationVoiceStream

> 擷取與此聊天控制項相關聯的音訊操作語音串流。

擷取與此聊天控制項相關聯的音訊操作語音串流。

## 語法

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

### 參數

**`sourceStream`**   [PartyAudioManipulationSourceStream\*\*](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyAudioManipulationSourceStream/partyaudiomanipulationsourcestream.md)\
*library-allocated output*

來源串流。

### 傳回值

PartyError

`c_partyErrorSuccess` (如果呼叫成功)，否則為錯誤碼。可透過 [PartyManager::GetErrorMessage()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage.md) 擷取錯誤碼的人類可讀形式。

## 備註

在本機聊天控制項中，串流代表本機音訊輸入偵測到的語音音訊。此串流提供的音訊已經過語音活動偵測 (VAD) 和自動增益控制 (AGC) 的前置處理。只有在偵測到語音活動時才會提供音訊。應用程式通常會透過 PartyAudioManipulationSourceStream::GetNextBuffer() 從此串流擷取音訊，使用應用程式邏輯處理音訊，然後將音訊提交回程式庫。將音訊提交回程式庫的方式是透過 PartyLocalChatControl::GetAudioManipulationCaptureStream() 擷取語音接收器串流，然後透過 [PartyAudioManipulationSinkStream::SubmitBuffer()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyAudioManipulationSinkStream/methods/partyaudiomanipulationsinkstream_submitbuffer.md) 提交緩衝區。 \
\
 透過 [PartyLocalChatControl::SynthesizeTextToSpeech()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_synthesizetexttospeech.md) 產生之 [PartySynthesizeTextToSpeechType::VoiceChat](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/enums/partysynthesizetexttospeechtype.md) 類型的音訊會透過此來源串流提供，因為這類音訊會作為相關聯使用者的語音。   \
\
 透過此串流擷取的音訊尚未透過語音轉文字進行語音聊天轉譯。如果透過 [PartyLocalChatControl::SetTranscriptionOptions](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions.md) 設定的轉譯選項指出應轉譯與接收器之聊天控制項相關聯的音訊，則透過 PartyAudioManipulationSinkStream::SubmitBuffer() 提交至接收器串流的音訊將會被轉譯。   \
\
 在遠端聊天控制項中，串流代表聊天控制項的傳入語音音訊。應用程式通常會透過 PartyAudioManipulationSourceStream::GetNextBuffer() 從與所有遠端聊天控制項相關聯的語音串流擷取音訊，將每個緩衝區處理並混合成單一音訊串流，然後提交混合後的串流，由每個適當的接收器串流轉譯。每個轉譯串流都可以透過 PartyLocalChatControl::GetAudioManipulationRenderStream() 擷取。

## 需求

**標頭：** Party.h

## 另請參閱

[PartyChatControl](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyChatControl/partychatcontrol.md)


## Related topics

- [PartyChatControl::ConfigureAudioManipulationVoiceStream](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyChatControl/methods/partychatcontrol_configureaudiomanipulationvoicestream.md)
- [PartyConfigureAudioManipulationVoiceStreamCompletedStateChange](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/structs/partyconfigureaudiomanipulationvoicestreamcompletedstatechange.md)
- [透過即時音訊操作套用自訂語音效果](https://docs.xbox.com/zh-TW/services/playfab/community/voice-communications/concepts-realtime-audio-manipulation.md)
- [PartyLocalChatControl::GetAudioManipulationRenderStream](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getaudiomanipulationrenderstream.md)
- [PartyLocalChatControl::GetAudioManipulationCaptureStream](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getaudiomanipulationcapturestream.md)