Kommandohändelse

[Microsoft Agent är inaktuell från och med Windows 7 och kan vara otillgänglig i efterföljande versioner av Windows.]

Beskrivning

Inträffar när användaren väljer ett (klientens) kommando.

syntax

underagent_Kommando(ByValUserInput**)**

Del

Beskrivning

UserInput

Identifierar -kommandot objekt som returneras av servern. Följande egenskaper kan nås från objektet Command: CharacterID Ett strängvärde som identifierar namnet (ID) för tecknet som tog emot kommandot. namn Ett strängvärde som identifierar kommandots namn (ID). Förtroende Ett långt heltalsvärde som anger konfidensbedömningen för kommandot. Voice Ett strängvärde som identifierar rösttexten för kommandot. Alt1Name Ett strängvärde som identifierar namnet på nästa (andra) bästa kommando. Alt1Confidence Ett långt heltalsvärde som anger konfidensbedömningen för nästa (andra) bästa kommando. Alt1Voice Ett strängvärde som identifierar rösttexten för den näst bästa alternativa kommandomatchningen. Alt2Name Ett strängvärde som identifierar namnet på den tredje bästa kommandomatchningen. Alt2Confidence Ett långt heltal som identifierar konfidensbedömningen för den tredje bästa kommandomatchningen. Alt2Voice Ett strängvärde som identifierar rösttexten för den tredje bästa kommandomatchningen. Antal Långt heltalsvärde som anger antalet returnerade alternativ.

Anmärkningar

Servern meddelar dig om den här händelsen när programmet är indataaktivt och användaren väljer ett kommando med talade indata eller teckens popup-meny. Händelsen skickar tillbaka antalet möjliga matchande kommandon i Count samt namn, konfidensbedömning och rösttext för dessa matchningar.

Om röstindata utlöser den här händelsen returnerar servern en sträng som identifierar den bästa matchningen i parametern Name och den andra och tredje bästa matchningen i Alt1Name och Alt2Name . En tom sträng anger att indata inte matchade något kommando som ditt program har definierat. Det kan till exempel vara ett av serverns definierade kommandon. Om kommandot matchades med agentens kommando; Till exempel Dölj, returneras en tom sträng i parametern Name, men du skulle fortfarande få texten som hörs i parametern Voice.

Du kan få samma kommandonamn returnerat i mer än en post. parametrarna Confidence, Alt1Confidence och Alt2Confidence returnerar de relativa poängen i intervallet -100 till 100 som returneras av taligenkänningsmotorn för varje matchning. parametrarna Voice, Alt1Voice och Alt2Voice returnerar rösttexten som taligenkänningsmotorn matchade för varje alternativ. Om Antal returnerar noll (0) identifierade servern talade indata, men fastställde att det inte fanns något matchande kommando.

Om röstindata inte var källan för kommandot, till exempel om användaren valde kommandot från tecknets popup-meny, returnerar servern namnet (ID) för kommandot som valts i egenskapen Name. Det returnerar också värdet för parametern Confidence som 100 och värdet för parametrarna Voice som den tomma strängen (""). Alt1Name och Alt2Name returnerar också tomma strängar. Alt1Confidence och Alt2Confidence returnerar noll (0) och Alt1Voice och Alt2Voice returnerar tomma strängar. Count returnerar 1.

Not

Alla taligenkänningsmotorer kan inte returnera alla värden för alla parametrar för den här händelsen. Kontakta motorleverantören för att avgöra om motorn stöder Microsoft Speech API-gränssnittet för att returnera alternativ och konfidenspoäng.