IAgentCharacterEx::SetTTSModeID

[Der Microsoft-Agent ist ab Windows 7 veraltet und kann in nachfolgenden Versionen von Windows nicht verfügbar sein.]

HRESULT SetTTSModeID(
   BSTR bszModeID  // TTS engine ID
);

Legt die Modus-ID des TTS-Moduls für das Zeichen fest.

• Gibt S_OK zurück, um anzugeben, dass der Vorgang erfolgreich war.

bszModeID

Die Einstellung der Modus-ID des TTS-Moduls für das Zeichen.

Anmerkung

IAgentCharacterEx:SetTTSModeID- kann fehlschlagen, wenn Speech.dll nicht installiert ist und das angegebene Modul nicht mit der kompilierten TTS-Moduseinstellung des Zeichens übereinstimmt.

 

Diese Einstellung bestimmt den bevorzugten Modulmodus für die gesprochene TTS-Ausgabe eines Zeichens. Die Modus-ID für ein TTS-Modul (Text-zu-Sprache) ist die GUID, die vom Sprachanbieter definiert wird, der den Modus des Moduls eindeutig identifiziert (formatiert mit geschweiften Klammern und Gedankenstrichen). Weitere Informationen finden Sie in der Microsoft Speech SDK-Dokumentation.

Wenn Sie eine TTS-Modus-ID festlegen, wird der Server versucht, ein Sprachmodul basierend auf der kompilierten TTS-Modus-ID des Zeichens, der aktuellen Systemsprachen-ID und der aktuellen Sprach-ID des Zeichens abzugleichen. Wenn Sie jedoch versuchen, eine Modus-ID festzulegen, wenn der Benutzer die Sprachausgabe im Eigenschaftenblatt des Microsoft Agent deaktiviert hat oder wenn das zugeordnete Modul nicht installiert ist, schlägt dieser Aufruf fehl.

Wenn Sie keine TTS-Modulmodus-ID für das Zeichen festlegen, legt der Server ein Modul fest, das der Spracheinstellung des Zeichens entspricht (mithilfe von Microsoft Speech API-Schnittstellen). Wenn Sie diese Eigenschaft festlegen, wird das zugeordnete Modul geladen, wenn sie noch nicht geladen ist.

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

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

Siehe auch

IAgentCharacterEx:GetTTSModeID