Zdarzenie polecenia

[Program Microsoft Agent jest przestarzały w systemie Windows 7 i może być niedostępny w kolejnych wersjach systemu Windows.

opis

Występuje, gdy użytkownik wybierze polecenie (klienta).

składni

Agentsub_Command(ByValUserInput**)**

Część

Opis

UserInput

Identyfikuje obiekt Command zwrócony przez serwer. Dostęp do następujących właściwości można uzyskać z obiektupolecenia: Identyfikator znaku Wartość ciągu identyfikującą nazwę (ID) znaku, który otrzymał polecenie. nazwa Wartość ciągu identyfikującą nazwę (ID) polecenia. zaufania Wartość długa liczba całkowita wskazująca wskaźnik ufności dla polecenia. Voice Wartość ciągu identyfikującą tekst głosowy polecenia. Alt1Name Wartość ciągu identyfikującą nazwę następnego (drugiego) najlepszego polecenia. Alt1Confidence Wartość długa liczba całkowita wskazująca punktację ufności dla następnego (drugiego) najlepszego polecenia. Alt1Voice Wartość ciągu identyfikującą tekst głosowy dla następnego najlepszego alternatywnego dopasowania polecenia. Alt2Name Wartość ciągu identyfikującą nazwę trzeciego najlepszego dopasowania polecenia. Alt2Confidence Długa liczba całkowita identyfikująca punktacji ufności dla trzeciego najlepszego dopasowania polecenia. Alt2Voice Wartość ciągu identyfikującą tekst głosowy dla trzeciego najlepszego dopasowania polecenia. liczby Długa wartość całkowita wskazująca liczbę zwracanych alternatyw.

Uwagi

Serwer powiadamia o tym zdarzeniu, gdy aplikacja jest aktywna, a użytkownik wybiera polecenie za pomocą wyskakującego menu danych wejściowych lub znaków mówionych. Zdarzenie przekazuje z powrotem liczbę możliwych pasujących poleceń w Liczba, a także nazwę, ocenianie ufności i tekst głosowy dla tych dopasowań.

Jeśli dane wejściowe głosowe wyzwalają to zdarzenie, serwer zwraca ciąg, który identyfikuje najlepsze dopasowanie w parametrze Name, a drugi i trzeci najlepszy dopasowanie w Alt1Name i Alt2Name . Pusty ciąg wskazuje, że dane wejściowe nie pasują do żadnego polecenia zdefiniowanego przez aplikację; na przykład może to być jedno ze zdefiniowanych poleceń serwera. Jeśli polecenie zostało dopasowane do polecenia agenta; na przykład Ukryj pusty ciąg zostanie zwrócony w parametrze Name, ale nadal będzie wyświetlany tekst słyszany w parametrzeVoice.

Ta sama nazwa polecenia może zostać zwrócona w więcej niż jednym wpisie. Wartości ufności, Alt1Confidence i Alt2Confidence zwracają względne wyniki w zakresie -100 do 100, które są zwracane przez aparat rozpoznawania mowy dla każdego dopasowania. Voice, Alt1Voice i Alt2Voice parametry zwracają tekst głosowy dopasowany przez aparat rozpoznawania mowy dla każdej alternatywy. Jeśli liczba zwraca zero (0), serwer wykrył wypowiedziane dane wejściowe, ale stwierdził, że nie ma pasującego polecenia.

Jeśli dane wejściowe głosowe nie były źródłem polecenia, na przykład jeśli użytkownik wybrał polecenie z wyskakującego menu znaku, serwer zwraca nazwę (ID) polecenia wybranego we właściwości Name. Zwraca również wartość parametru Confidence jako 100, a wartość parametru Voice jako pusty ciąg (""). Alt1Name i Alt2Name również zwracają puste ciągi. Alt1Confidence i Alt2Confidence zwracają zero (0), a Alt1Voice i Alt2Voice zwracają puste ciągi. liczba zwraca wartość 1.

Nuta

Nie wszystkie aparaty rozpoznawania mowy mogą zwracać wszystkie wartości dla wszystkich parametrów tego zdarzenia. Zajrzyj do dostawcy aparatu, aby ustalić, czy aparat obsługuje interfejs API rozpoznawania mowy firmy Microsoft na potrzeby zwracania alternatyw i wyników ufności.