Befehlsereignis
[Der Microsoft-Agent ist ab Windows 7 veraltet und in nachfolgenden Versionen von Windows möglicherweise nicht mehr verfügbar.]
-
Beschreibung
-
Tritt ein, wenn der Benutzer einen Befehl (Client) ausgibt.
-
Syntax
-
Befehl des Sub-Agents _ (ByVal UserInput))*
Teil Beschreibung UserInput Identifiziert das vom Server zurückgegebene Command-Objekt.
Auf die folgenden Eigenschaften kann über das Command-Objekt zugegriffen werden:
CharacterID
Ein Zeichenfolgenwert, der den Namen (ID) des Zeichens identifiziert, das den Befehl empfangen hat.
Name
Ein Zeichenfolgenwert, der den Namen (ID) des Befehls identifiziert.
Vertrauen
Ein ganzzahliger Wert vom Typ Long, der die Zuverlässigkeitsbewertung für den Befehl angibt.
Voice
Ein Zeichenfolgenwert, der den Sprachtext für den Befehl identifiziert.
ALT1Name
Ein Zeichenfolgenwert, der den Namen des nächsten (zweiten) besten Befehls identifiziert.
ALT1Confidence
Ein ganzzahliger Wert vom Typ Long, 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 Befehls übereinstimmung identifiziert.
ALT2Name
Ein Zeichenfolgenwert, der den Namen der dritten besten Befehls übereinstimmung identifiziert.
ALT2Confidence
Eine Long-Ganzzahl, die die Zuverlässigkeitsbewertung für die dritte beste Befehls übereinstimmung identifiziert.
ALT2Voice
Ein Zeichenfolgenwert, der den Sprachtext für die dritte beste Befehls übereinstimmung identifiziert.
Anzahl
Long integer value (Langer ganzzahliger Wert), der die Anzahl der zurückgegebenen Alternativen angibt.
Hinweise
Der Server benachrichtigt Sie über dieses Ereignis, wenn Ihre Anwendung eingabeaktiv ist und der Benutzer einen Befehl durch gesprochene Eingabe oder das Popupmenü des Zeichens auswählt. 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 zurück.
Wenn die Spracheingabe dieses Ereignis auslöst, gibt der Server eine Zeichenfolge zurück, die die beste Übereinstimmung im Name-Parameter identifiziert, und die zweite und dritte beste Übereinstimmung in ALT1Name und ALT2Name. Eine leere Zeichenfolge gibt an, dass die Eingabe mit keinem Befehl übereinstimmt, den Ihre Anwendung definiert hat. Dies kann beispielsweise einer der definierten Befehle des Servers sein. Wenn der Befehl mit dem -Befehl des -Agents übereinstimmte, Beispielsweise würde hide eine leere Zeichenfolge im Name-Parameter zurückgegeben, aber Sie würden weiterhin den Text erhalten, der im Voice-Parameter gehört wird.
Möglicherweise wird der gleiche Befehlsname in mehreren Einträgen zurückgegeben. Die Parameter Confidence,Alt1Confidence und Alt2Confidence geben die relativen Bewertungen im Bereich von -100 bis 100 zurück, die von der Spracherkennungs-Engine für jede entsprechende Übereinstimmung zurückgegeben werden. Die Parameter Voice,Alt1Voice und Alt2Voice geben den Sprachtext zurück, den die Spracherkennungs-Engine für jede Alternative gefunden hat. Wenn Count null (0) zurückgibt, hat der Server gesprochene Eingaben erkannt, aber festgestellt, dass kein übereinstimmender Befehl vorhanden war.
Wenn die Spracheingabe nicht die Quelle für den Befehl war, z. B. wenn der Benutzer den Befehl im 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 Confidence-Parameters 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 für die Rückgabe von Alternativen und Zuverlässigkeitsbewertungen unterstützt.