Command-Ereignis

[Der Microsoft Agent ist seit Windows 7 veraltet und kann in späteren Versionen von Windows nicht mehr verfügbar sein.]

Beschreibung

Tritt auf, wenn der Benutzer einen (Client-)Befehl auswählt.

Syntax

Subagent_Command(ByValUserInput**)**

Teil

Beschreibung

UserInput

Identifiziert das Command-Objekt, das vom Server zurückgegeben wird. Auf die folgenden Eigenschaften kann über das Command-Objekt zugegriffen werden: CharacterID Ein Zeichenfolgenwert, der den Namen (ID) des Charakters angibt, der den Befehl empfangen hat. Name Ein Zeichenfolgenwert, der den Namen (ID) des Befehls identifiziert. Zuverlässigkeit Ein Long Integer-Wert, der die Konfidenzbewertung für den Befehl angibt. Sprachanruf Ein Zeichenfolgenwert, der den Sprachtext für den Befehl identifiziert. Alt1Name Ein Zeichenfolgenwert, der den Namen des nächsten (zweit)besten Befehls angibt. Alt1Confidence Ein Long Integer-Wert, der die Konfidenzbewertung für den nächsten (zweitbesten) Befehl angibt. Alt1Voice Ein Zeichenfolgenwert, der den Sprachtext für die nächstbeste alternative Befehlsübereinstimmung identifiziert. Alt2Name Ein Zeichenfolgenwert, der den Namen der drittbesten Befehlsübereinstimmung identifiziert. Alt2Confidence Ein Long Integer-Wert, der die Konfidenzbewertung für die drittbeste Befehlsübereinstimmung angibt. Alt2Voice Ein Zeichenfolgenwert, der den Sprachtext für die drittbeste Befehlsübereinstimmung identifiziert. Count Ein Long Integer-Wert, der die Anzahl der zurückgegebenen Alternativen angibt.

Hinweise

Der Server benachrichtigt Sie mit diesem Ereignis, wenn Ihre Anwendung eingabeaktiv ist und der Benutzer einen Befehl per Spracheingabe oder über das Popupmenü eines Charakters auswählt. Das Ereignis übergibt die Anzahl der möglichen übereinstimmenden Befehle in Count sowie den Namen, die Konfidenzbewertung 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 und die zweit- und drittbeste Übereinstimmung in Alt1Name und Alt2Name identifiziert. Eine leere Zeichenfolge zeigt an, dass die Eingabe keinem von Ihrer Anwendung definierten Befehl entspricht. Es könnte sich beispielsweise um einen der vom Server definierten Befehle handeln. Wenn der Befehl mit dem Befehl des Agents übereinstimmt, z. B. Ausblenden, wird eine leere Zeichenfolge im Parameter Name zurückgegeben. Sie erhalten jedoch weiterhin den im Parameter Voice gehörten Text.

Möglicherweise wird derselbe Befehlsname in mehr als einem Eintrag zurückgegeben. Die Parameter Confidence, Alt1Confidence und Alt2Confidence geben die relativen Punktzahlen im Bereich von -100 bis 100 zurück, die vom Spracherkennungsmodul für jede Übereinstimmung zurückgegeben werden. Die Parameter Voice, Alt1Voice und Alt2Voice geben den Sprachtext zurück, den das Spracherkennungsmodul für jede Alternative gefunden hat. Wenn Count null (0) zurückgibt, hat der Server die gesprochene Eingabe erkannt, aber festgestellt, dass kein übereinstimmender Befehl vorhanden war.

Wenn die Spracheingabe nicht die Quelle des Befehls war, z. B. wenn der Benutzer den Befehl aus dem Popupmenü des Charakters ausgewählt hat, gibt der Server den Namen (ID) des ausgewählten Befehls in der Eigenschaft Name zurück. Außerdem wird der Wert des Parameters Confidence als 100 zurückgegeben, und der Wert des Parameters Voice als leere Zeichenfolge (""). Alt1Name und Alt2Name geben auch 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.