Command-Ereignis

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

Beschreibung

Tritt auf, wenn der Benutzer einen Befehl (des Clients) auswäht.

Syntax

Subagent_Command(ByValUserInput**)**

Teil

BESCHREIBUNG

UserInput

Gibt das vom Server zurückgegebene Command-Objekt an. Auf die folgenden Eigenschaften kann über das Command-Objekt zugegriffen werden: CharacterID Ein Zeichenfolgenwert, der den Namen (ID) des Zeichens angibt, das den Befehl empfangen hat. Name Ein Zeichenfolgenwert, der den Namen (ID) des Befehls angibt. Confidence Ein ganzzahliger Long-Wert, der die Konfidenzbewertung für den Befehl angibt. Sprache Ein Zeichenfolgenwert, der den Sprachtext für den Befehl identifiziert. Alt1Name Ein Zeichenfolgenwert, der den Namen des nächsten (zweiten) besten Befehls angibt. Alt1Confidence Ein long-ganzzahliger Wert, der die Zuverlässigkeitsbewertung für den nächsten (zweiten) besten Befehl angibt. Alt1Voice Ein Zeichenfolgenwert, der den Sprachtext für die nächstbeste alternative Befehlsverbindung angibt. Alt2Name Ein Zeichenfolgenwert, der den Namen der drittbesten Befehlsmatches angibt. Alt2Confidence Eine lange ganze Zahl, die die Zuverlässigkeitsbewertung für die drittbeste Befehlsmatches angibt. Alt2Voice Ein Zeichenfolgenwert, der den Sprachtext für die drittbeste Befehlsverbindung angibt. Anzahl Long integer value, der die Anzahl der zurückgegebenen Alternativen angibt.

Bemerkungen

Der Server benachrichtigt Sie mit diesem Ereignis, wenn Ihre Anwendung eingabeaktiv ist und der Benutzer einen Befehl anhand der gesprochenen Eingabe oder des Popupmenüs des Zeichens auswährt. Das Ereignis übergibt die Anzahl der möglichen übereinstimmenden Befehle in Count sowie den Namen, die Zuverlässigkeitsbewertung und den Sprachtext für diese Übereinstimmungen.

Wenn die Spracheingabe dieses Ereignis auslöst, gibt der Server eine Zeichenfolge zurück, die die beste Übereinstimmung im Parameter Name sowie die zweit- und drittbeste Übereinstimmung in Alt1Name und Alt2Name identifiziert. Eine leere Zeichenfolge gibt an, dass die Eingabe mit keinem befehl übereinstimmt, den Ihre Anwendung definiert hat. Beispielsweise könnte es sich um einen der definierten Befehle des Servers handelt. Wenn der Befehl mit dem Befehl des Agents abgeglichen wurde; Beispielsweise wird im Parameter Name eine leere Zeichenfolge zurückgegeben, aber Sie erhalten weiterhin den im Voice-Parameter gehörten Text.

Möglicherweise wird derselbe Befehlsname in mehreren Einträgen zurückgegeben. Die Parameter Confidence, Alt1Confidence und Alt2Confidence geben die relativen Ergebnisse im Bereich von -100 bis 100 zurück, die von der Spracherkennungs-Engine für jede übereinstimmung zurückgegeben werden. Die Parameter Voice, Alt1Voice und Alt2Voice geben den Sprachtext zurück, den die Spracherkennungs-Engine für jede Alternative abgeglichen hat. Wenn Count null (0) zurückgibt, hat der Server eine gesprochene Eingabe erkannt, aber festgestellt, dass kein übereinstimmende Befehl vorhanden ist.

Wenn die Spracheingabe nicht die Quelle für den Befehl war, z. B. wenn der Benutzer den Befehl aus dem Popupmenü des Zeichens ausgewählt hat, gibt der Server den Namen (ID) des in der Name-Eigenschaftausgewählten Befehls zurück. Außerdem wird der Wert des Parameters Confidence als 100 und der Wert der Voice-Parameter als leere Zeichenfolge ("") zurückgegeben. Alt1Name und Alt2Name geben ebenfalls leere Zeichenfolgen zurück. Alt1Confidence und Alt2Confidence geben null (0) zurück, und Alt1Voice und Alt2Voice geben leere Zeichenfolgen zurück. Count gibt 1 zurück.

Hinweis

Nicht alle Spracherkennungs-Engines geben möglicherweise alle Werte für alle Parameter dieses Ereignisses zurück. Wenden Sie sich an Ihren Engine-Anbieter, um zu ermitteln, ob die Engine die Microsoft Speech-API-Schnittstelle unterstützt, um Alternativen und Zuverlässigkeitsbewertungen zurückzugeben.