Freigeben über


PartyLocalChatControl::SetTranscriptionOptions

Konfiguriert die Transkriptionsoptionen, die sprachchataudio für dieses Chat-Steuerelement zugeordnet sind.

Syntax

PartyError SetTranscriptionOptions(  
    PartyVoiceChatTranscriptionOptions options,  
    void* asyncIdentifier  
)  

Parameter

options PartyVoiceChatTranscriptionOptions

Optionen, die der Sprachchattranskription zugeordnet sind, z. B. welche Chatsteuerelemente Transkriptionen für das lokale Chatsteuerelement generieren sollen, und ob diese Transkriptionen in die Sprache des lokalen Chatsteuerelements übersetzt werden sollen.

asyncIdentifier Leere*
Optional

Ein optionaler, app-definierter Kontextwert in Zeigergröße, der verwendet werden kann, um die Änderung des Abschlusszustands diesem Aufruf zuzuordnen.

Rückgabewert

PartyError

c_partyErrorSuccess , wenn der asynchrone Vorgang zum Festlegen der Transkriptionsoptionen gestartet wurde, oder andernfalls ein Fehlercode. Wenn bei dieser Methode ein Fehler auftritt, werden keine zugehörigen Zustandsänderungen generiert. Die lesbare Form des Fehlercodes kann über PartyManager::GetErrorMessage() abgerufen werden.

Hinweise

Transkription ist der Prozess der Generierung von Zeichenfolgen, die gesprochene Ausdrücke im Sprachchat darstellen. Die über options angegebenen Optionen geben die Chatsteuerelemente an, die diese Transkriptionszeichenfolgen generieren sollen, die anschließend dem lokalen Chat-Steuerelement über PartyVoiceChatTranscriptionReceivedStateChanges bereitgestellt werden.

Nur Chatsteuerelemente, die über PartyLocalDevice::CreateChatControl() für die Verwendung einer Sprache konfiguriert sind, die Transkription unterstützt, stellen Transkriptionen bereit.

Die Sprach-in-Text-Transkription verwendet intern verfügbare Regions- und Latenzmessungen, um die Dienstnutzung zu optimieren. Wenn die Option PartyOption::RegionUpdateConfiguration verwendet wurde, um einen Updatemodus von PartyRegionUpdateMode::D eferred zu konfigurieren, wurde das Abrufen der verfügbaren Regionen und das Messen der Verbindungsqualität für sie möglicherweise noch nicht gestartet, oder das letzte Update hat möglicherweise das konfigurierte Aktualisierungsintervallalter überschritten. Wenn das lokale Gerät derzeit keine Verbindung mit Netzwerken herstellt oder mit diesen verbunden ist und die Anwendung Optionsflags angibt, die PartyVoiceChatTranscriptionOptions::TranscribeSelfRegardlessOfNetworkState enthalten, stellt SetTranscriptionOptions() sicher, dass alle verzögerten Regionsupdates gestartet wurden und die zugeordnete PartyRegionsChangedStateChange vor dem Abschluss dieses AufrufsSet PartyTranscriptionOptionsCompletedStateChange bereitgestellt wird.

Voraussetzungen

Header: Party.h

Weitere Informationen

PartyLocalChatControl