Share via

SRModeID-Eigenschaft

  • Artikel

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

Beschreibung

Gibt die Vom Zeichen verwendete Spracherkennungs-Engine zurück oder legt sie fest.

Syntax

agent**. Zeichen("CharacterID"). SRModeID** [ = ModeID]

Teil BESCHREIBUNG
ModeID Ein Zeichenfolgenausdruck, der der Modus-ID einer Sprach-Engine entspricht.

 

Bemerkungen

Die -Eigenschaft bestimmt die Spracherkennungs-Engine, die vom Zeichen für die Spracheingabe verwendet wird. Die Modus-ID für eine Spracherkennungs-Engine ist eine formatierte Zeichenfolge, die vom Sprachanbieter definiert wird und die Engine eindeutig identifiziert. Weitere Informationen finden Sie unter Zugreifen auf eine Sprach-Engine in Ihrem Code.

Wenn Sie eine Modus-ID für eine Sprach-Engine angeben, die nicht installiert ist, wenn der Benutzer die Spracherkennung deaktiviert hat (im Microsoft Agent-Eigenschaftenblatt), oder wenn die Sprache des angegebenen Sprachmoduls nicht mit der LanguageID-Einstellung des Zeichens übereinstimmt, löst der Server einen Fehler aus.

Wenn Sie diese Eigenschaft abfragen und die Spracherkennungs-Engine noch nicht (erfolgreich) festgelegt haben, gibt der Server die Modus-ID der Engine zurück, die SAPI basierend auf der LanguageID-Einstellung des Zeichens zurückgibt. Wenn Sie die LanguageID des Zeichens nicht festgelegt haben, gibt der Agent die Modus-ID der Engine zurück, die SAPI basierend auf der Standardsprach-ID des Benutzers zurückgibt. Wenn keine übereinstimmende Engine vorhanden ist, gibt der Server eine leere Zeichenfolge ("") zurück. Das Abfragen dieser Eigenschaft erfordert nicht, dass SpeechInput.Enabled auf True festgelegt ist. Wenn Sie jedoch die Eigenschaft abfragen, wenn die Spracheingabe deaktiviert ist, gibt der Server eine leere Zeichenfolge zurück.

Wenn die Spracheingabe aktiviert ist (im Fenster Erweiterte Zeichenoptionen), wird durch Abfragen oder Festlegen dieser Eigenschaft die zugeordnete Engine geladen (sofern sie nicht bereits geladen ist) und Sprachdienste gestartet. Das heißt, die Lauschtaste ist verfügbar, und der Hörtipp kann angezeigt werden. (Die Hörtaste und der Tipp zum Abhören sind nur aktiviert, wenn sie auch in erweiterten Zeichenoptionen aktiviert sind.) Wenn Sie jedoch die Eigenschaft abfragen, wenn die Sprache deaktiviert ist, startet der Server keine Sprachdienste.

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

Die Sprach-Engine-Anforderungen des Microsoft-Agents basieren auf der Microsoft Speech-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 Abfragen dieser Eigenschaft gibt in der Regel keinen Fehler zurück. Wenn das Laden des Sprachmoduls jedoch ungewöhnlich lange dauert, erhalten Sie möglicherweise einen Fehler, der darauf hinweist, dass die Abfrage ein Timeout aufweist.

 

Weitere Informationen

LanguageID-Eigenschaft