PartyChatControl::GetAudioManipulationVoiceStream
Ruft den Sprachdatenstrom für die Audiobearbeitung ab, der diesem Chatsteuerelement zugeordnet ist.
Syntax
PartyError GetAudioManipulationVoiceStream(
PartyAudioManipulationSourceStream** sourceStream
)
Parameter
sourceStream
PartyAudioManipulationSourceStream**
Bibliotheksseitig zugeordnete Ausgabe
Der Quellstream.
Rückgabewert
PartyError
c_partyErrorSuccess
, wenn der Aufruf erfolgreich war oder andernfalls ein Fehlercode vorliegt. Die lesbare Form des Fehlercodes kann über PartyManager::GetErrorMessage() abgerufen werden.
Hinweise
In einem lokalen Chat-Steuerelement stellt der Stream die Sprachaudio dar, die von der lokalen Audioeingabe erkannt wird. Von diesem Datenstrom bereitgestellte Audio wurde bereits mit der Sprachaktivitätserkennung (Voice Activity Detection, VAD) und der automatischen Verstärkungssteuerung (Automatic Gain Control, AGC) vorverarbeitet. Audio wird nur bereitgestellt, wenn sprachaktive Aktivitäten erkannt werden. In der Regel ruft die App Audiodaten aus diesem Stream über PartyAudioManipulationSourceStream::GetNextBuffer() ab, verarbeitet die Audiodaten mithilfe der App-Logik und sendet die Audiodaten dann zurück an die Bibliothek. Die Audiodaten werden zurück an die Bibliothek übermittelt, indem der Sprachsenkendatenstrom über PartyLocalChatControl::GetAudioManipulationCaptureStream() abgerufen und dann der Puffer über PartyAudioManipulationSinkStream::SubmitBuffer() übermittelt wird.
Audio, das über PartyLocalChatControl::SynthesizeTextToSpeech() vom Typ PartySynthesizeTextToSpeechType::VoiceChat generiert wird, wird über diesen Quelldatenstrom bereitgestellt, da diese Audiodaten als Stimme des zugeordneten Benutzers fungieren.
Audio, das über diesen Datenstrom abgerufen wurde, wurde nicht per Spracherkennung für die Sprachchattranskription transkribiert. Audiodaten, die über PartyAudioManipulationSinkStream::SubmitBuffer() an einen Senkendatenstrom übermittelt werden, werden transkribiert, wenn transkriptionsoptionen, die über PartyLocalChatControl::SetTranscriptionOptions konfiguriert wurden, angeben, dass audio dem Chat-Steuerelement der Senke zugeordnet sein sollte.
In einer Remotechatsteuerung stellt der Stream die eingehende Sprachaudio des Chatsteuerelements dar. In der Regel ruft die App Audiodaten aus den Sprachstreams ab, die allen Remotechatsteuerelementen über PartyAudioManipulationSourceStream::GetNextBuffer() zugeordnet sind, verarbeitet jeden Puffer und mischt sie in einem einzelnen Audiostream und übermittelt dann den gemischten Datenstrom, der von jedem entsprechenden Senkenstream gerendert werden soll. Jeder Renderstream kann über PartyLocalChatControl::GetAudioManipulationRenderStream() abgerufen werden.
Anforderungen
Kopfball: Party.h