Freigeben über


TTSModeID-Eigenschaft

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

Beschreibung

Gibt den TTS-Modulmodus zurück, der für das Zeichen verwendet wird, oder legt den Modus fest.

Syntax

Agent**. Characters ("CharacterID"). TTSModeID** [ = ModeID]

Teil Beschreibung
ModeID- Ein Zeichenfolgenausdruck, der der Modus-ID eines Sprachmoduls entspricht.

 

Bemerkungen

Diese Eigenschaft bestimmt die TTS-Modulmodus-ID (Text-zu-Sprache) für die gesprochene Ausgabe eines Zeichens. Die Modus-ID für ein TTS-Modul ist eine formatierte Zeichenfolge, die vom Sprachanbieter definiert wird, der den Modulmodus eindeutig identifiziert. Weitere Informationen finden Sie unter Zugreifen auf ein Sprachmodul in Ihrem Code.

Durch Festlegen dieser Eigenschaft wird der Versuch des Servers überschrieben, ein Modul basierend auf der kompilierten TTS-Einstellung des Zeichens und der aktuellen LanguageID Einstellung des Zeichens zu laden. Wenn Sie jedoch eine Modus-ID für ein nicht installiertes Modul angeben oder die Sprachausgabe des Benutzers im Eigenschaftenblatt des Microsoft Agent deaktiviert hat (AudioOutput.Enabled = False), löst der Server einen Fehler aus.

Wenn Sie eine TTS-Modus-ID für das Zeichen nicht (oder nicht erfolgreich) festgelegt haben, überprüft der Server, ob die kompilierte TTS-Moduseinstellung des Zeichens der LanguageID-Einstellung des Zeichens entspricht und das zugeordnete TTS-Modul installiert ist. In diesem Fall gibt der TTS-Modus, der vom Zeichen für die gesprochene Ausgabe verwendet wird, und diese Eigenschaft gibt diese Modus-ID zurück. Andernfalls fordert der Server ein kompatibles SAPI-Sprachmodul an, das der LanguageID- des Zeichens entspricht, sowie das Geschlecht und das Alter, das für die Kompilierungsmodus-ID des Zeichens festgelegt wurde. Wenn Sie die LanguageID-des Zeichens nicht festgelegt haben, ist die LanguageID- die aktuelle Benutzersprache. Wenn kein übereinstimmendes Modul gefunden werden kann, gibt die Abfrage für diese Eigenschaft eine leere Zeichenfolge für die Modulmodus-ID zurück. Wenn Sie diese Eigenschaft abfragen, wenn der Benutzer die Sprachausgabe im Eigenschaftenblatt des Microsoft Agent deaktiviert hat (AudioOutput.Enabled = False), ist der Wert eine leere Zeichenfolge.

Durch Abfragen oder Festlegen dieser Eigenschaft wird das zugeordnete Modul geladen (sofern sie noch nicht geladen wurde). Wenn das in der kompilierten TTS-Einstellung des Zeichens angegebene Modul jedoch installiert ist und der Sprach-ID-Einstellung des Zeichens entspricht, wird das Modul geladen, wenn das Zeichen geladen wird.

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.

Anmerkung

Diese Eigenschaft gibt auch die leere Zeichenfolge zurück, wenn auf Ihrem System keine kompatible Soundunterstützung installiert ist.

 

Anmerkung

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

 

Anmerkung

Beim Abfragen dieser Eigenschaft wird in der Regel kein Fehler zurückgegeben. Wenn das Sprachmodul jedoch eine ungewöhnlich lange Ladezeit benötigt, wird möglicherweise ein Fehler angezeigt, der angibt, dass die Abfrage timeout war.

 

Siehe auch

LanguageID-Eigenschaft