IAgentCharacterEx::GetTTSModeID

[Der Microsoft-Agent ist ab Windows 7 veraltet und in nachfolgenden Versionen von Windows möglicherweise nicht mehr verfügbar.]

HRESULT GetTTSModeID(
   BSTR * pbszModeID  // address of TTS engine ID
);

Ruft die Modus-ID des TTS-Engine-Satzes für das Zeichen ab.

  • Gibt S _ OK zurück, um anzugeben, dass der Vorgang erfolgreich war.

pbszModeID

Adresse eines BSTR, der die Modus-ID-Einstellung der TTS-Engine für das Zeichen empfängt.

Diese Einstellung gibt die TTS-Engine-Modus-ID (Text-to-Speech) für die gesprochene Ausgabe eines Zeichens zurück. Die Modus-ID für eine TTS-Engine ist eine Zeichenfolgendarstellung der GUID (formatiert mit geschweiften Klammern und Bindestrichen), die vom Sprachanbieter definiert wird, der die Engine eindeutig identifiziert. Weitere Informationen finden Sie in der Dokumentation zum Microsoft Speech SDK. Wenn Sie diese Eigenschaft abfragen, wird die zugeordnete Engine geladen, wenn sie noch nicht geladen wurde.

Wenn Sie keine TTS-Engine-Modus-ID für das Zeichen festlegen, versucht der Server, eine Engine zurückzugeben, die der kompilierten TTS-Einstellung des Zeichens und der aktuellen Spracheinstellung des Zeichens entspricht (mithilfe von Microsoft Speech-API-Schnittstellen). Wenn diese unterschiedlich sind, überschreibt die Spracheinstellung des Zeichens seine Einstellung für den erstellungsmodus. Wenn Sie die Spracheinstellung des Zeichens nicht festgelegt haben, ist die Sprache des Zeichens die Standardsprach-ID des Benutzers, und der Server versucht die Übereinstimmung basierend auf dieser Sprach-ID.

Diese Funktion schlägt nicht fehl, wenn IAgentAudioObjectProperties::GetEnabled False zurückgibt.

Diese Eigenschaft gilt nur für die Verwendung des Zeichens durch Ihre Clientanwendung. Die Einstellung wirkt sich nicht auf andere Clients des Zeichens oder anderer Zeichen Ihrer Clientanwendung aus.

Die Anforderungen der Sprach-Engine des Microsoft-Agents basieren auf der Microsoft Speech-API. Engines, die die SAPI-Anforderungen des Microsoft-Agents unterstützen, können installiert und mit dem Agent verwendet werden.

Weitere Informationen

IAgentCharacterEx::SetTTSModeID