TTSModeID-Eigenschaft
[Der Microsoft-Agent ist ab Windows 7 veraltet und in nachfolgenden Versionen von Windows möglicherweise nicht verfügbar.]
-
Beschreibung
-
Gibt den TTS-Engine-Modus zurück, der für das Zeichen verwendet wird, oder legt diese fest.
-
Syntax
-
Agent**. Zeichen ("CharacterID"). TTSModeID** [ = ModeID]
Teil Beschreibung ModeID Ein Zeichenfolgenausdruck, der der Modus-ID einer Sprach-Engine entspricht.
Bemerkungen
Diese Eigenschaft bestimmt die TTS-Engine-Modus-ID (Text-to-Speech) für die gesprochene Ausgabe eines Zeichens. Die Modus-ID für eine TTS-Engine ist eine formatierte Zeichenfolge, die vom Sprachanbieter definiert wird und den Modus der Engine eindeutig identifiziert. Weitere Informationen finden Sie unter Zugreifen auf eine Speech-Engine in Ihrem Code.
Das Festlegen dieser Eigenschaft überschreibt den Versuch des Servers, eine Engine 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 eine Engine angeben, die nicht installiert ist, oder wenn der Benutzer die Sprachausgabe im Microsoft Agent-Eigenschaftenblatt deaktiviert hat (AudioOutput.Enabled = False), löst der Server einen Fehler aus.
Wenn Sie nicht (oder nicht erfolgreich) eine TTS-Modus-ID für das Zeichen festgelegt haben, überprüft der Server, ob die Einstellung für den kompilierten TTS-Modus des Zeichens mit der LanguageID-Einstellung des Zeichens übereinstimmt und ob die zugehörige TTS-Engine installiert ist. Wenn dies der Fall ist, gibt der TTS-Modus, der vom Zeichen für die gesprochene Ausgabe verwendet wird, und diese Eigenschaft diese Modus-ID zurück. Wenn dies nicht der Fall ist, fordert der Server eine kompatible SAPI-Sprach-Engine an, die der LanguageID des Zeichens sowie dem Geschlecht und dem Alter für die ID des kompilierten Modus des Zeichens entspricht. Wenn Sie die LanguageID des Zeichens nicht festgelegt haben, ist dessen LanguageID die aktuelle Benutzersprache. Wenn keine übereinstimmende Engine gefunden werden kann, gibt die Abfrage nach dieser Eigenschaft eine leere Zeichenfolge für die Modus-ID der Engine zurück. Wenn Sie diese Eigenschaft abfragen, wenn der Benutzer die Sprachausgabe im Microsoft-Agent-Eigenschaftenblatt deaktiviert hat (AudioOutput.Enabled = False), ist der Wert eine leere Zeichenfolge.
Durch Abfragen oder Festlegen dieser Eigenschaft wird die zugeordnete Engine geladen (sofern sie noch nicht geladen ist). Wenn jedoch die in der kompilierten TTS-Einstellung des Zeichens angegebene Engine installiert ist und der Sprach-ID des Zeichens entspricht, wird die Engine geladen, wenn das Zeichen geladen wird.
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 Sprach-Engine-Anforderungen des Microsoft-Agents basieren auf der Microsoft-Spracherkennungs-API. Engines, die die SAPI-Anforderungen des Microsoft-Agents unterstützen, können mit dem Agent installiert und verwendet werden.
Hinweis
Diese Eigenschaft gibt auch die leere Zeichenfolge zurück, wenn auf Ihrem System keine kompatible Soundunterstützung installiert ist.
Hinweis
Das Festlegen der TTSModeID kann fehlschlagen, wenn Speech.dll nicht installiert ist und die angegebene Engine nicht mit der Einstellung für den kompilierten TTS-Modus des Zeichens übereinstimmt.
Hinweis
Das Abfragen dieser Eigenschaft gibt in der Regel keinen Fehler zurück. Wenn das Laden der Sprach-Engine jedoch ungewöhnlich lange dauert, erhalten Sie möglicherweise einen Fehler, der darauf hinweist, dass für die Abfrage ein Timeout aufgetreten ist.
Weitere Informationen