PartyLocalChatControl::SetTextToSpeechProfile

Artikel
08/10/2024

Konfiguriert das Profil, das für einen angegebenen Text-zu-Sprache-Vorgang verwendet werden soll.

Syntax

PartyError SetTextToSpeechProfile(  
    PartySynthesizeTextToSpeechType type,  
    PartyString profileIdentifier,  
    void* asyncIdentifier  
)

Parameter

type PartySynthesizeTextToSpeechType

Der Typ der Text-zu-Sprache-Vorgänge, für die das angegebene Profil verwendet werden soll.

profileIdentifier PartyString

Der Bezeichner des Profils, das Sprachsynthesevorgänge des angegebenen Typs verwenden 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 des Text-zu-Sprache-Profils 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

Das angegebene Profil wird für alle nachfolgenden Aufrufe von SynthesizeTextToSpeech() verwendet, die denselben Wert für typeangeben. Es wird kein Profil konfiguriert, bis SetTextToSpeechProfile() mindestens einmal aufgerufen wird. Daher muss diese Methode mindestens einmal aufgerufen werden, bevor Aufrufe von SynthesizeTextToSpeech() erfolgreich sind.

Diese Methode akzeptiert einen Profilbezeichner, um die Profilauswahl anzugeben, sodass Titel entweder das Ergebnis von PartyTextToSpeechProfile::GetIdentifier() übergeben oder einen Profilbezeichner bereitstellen können, der aus einer vorherigen Parteibibliothekssitzung zwischengespeichert wurde.

Mehrere SetTextToSpeechProfile()-Vorgänge können initiiert werden und werden asynchron in die Warteschlange eingereiht. Jeder Vorgang wird in der richtigen Reihenfolge verarbeitet und abgeschlossen.

Dies ist ein asynchroner Vorgang. ein PartySetTextToSpeechProfileCompletedStateChange wird nach Abschluss über PartyManager::StartProcessingStateChanges() bereitgestellt.

Die Text-zu-Sprache-Synthesefunktion 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 ihnen verbunden ist, stellt SetTextToSpeechProfile() sicher, dass eine verzögerte Regionsaktualisierung gestartet wurde und die zugeordnete PartyRegionsChangedStateChange vor abschluss des PartySetTextToSpeechProfileCompletedStateChange-Abschlusses dieses Aufrufs bereitgestellt wird.

Voraussetzungen

Header: Party.h

Weitere Informationen

PartyLocalChatControl
PartyLocalChatControl::GetTextToSpeechProfile

Freigeben über