Listen, metoda

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

opis

Włącza tryb nasłuchiwania (rozpoznawanie mowy) przez określony czas.

składni

agenta.znaki("Identyfikator znaku"). Nasłuchiwanie** stanu

Część	Opis
stanu	Wymagane. Wartość logiczna określająca, czy włączyć lub wyłączyć tryb nasłuchiwania. true włącza tryb nasłuchiwania. false wyłącza tryb nasłuchiwania.

Uwagi

Ustawienie tej metody na true włącza tryb nasłuchiwania (włącza rozpoznawanie mowy) przez stały czas (10 sekund). Chociaż nie można ustawić wartości limitu czasu, możesz wyłączyć tryb nasłuchiwania przed upływem limitu czasu. Jeśli (lub inny klient) pomyślnie ustawisz tryb nasłuchiwania i spróbujesz ustawić tę właściwość na wartość true przed upływem limitu czasu, metoda zakończy się pomyślnie i zresetuje limit czasu. Jeśli jednak tryb nasłuchiwania jest włączony, ponieważ użytkownik naciska Nasłuchiwanie, metoda powiedzie się, ale limit czasu jest ignorowany, a tryb nasłuchiwania kończy się na podstawie interakcji użytkownika z kluczem nasłuchiwania.

Ta metoda powiedzie się tylko wtedy, gdy wywołana przez klienta wejściowego aktywne i czy usługi mowy zostały uruchomione. Aby upewnić się, że usługi mowy zostały uruchomione, wykonaj zapytanie lub ustaw SRModeID lub ustaw ustawienieVoice dla Command przed wywołaniem Listen w przeciwnym razie metoda zakończy się niepowodzeniem. Aby wykryć powodzenie tej metody, wywołaj ją jako funkcję i zwróci wartość logiczną wskazującą, czy metoda zakończyła się pomyślnie.

   If Genie.Listen(True) Then
      'The method succeeded

   Else
      ' The method failed

   End If

Metoda również kończy się niepowodzeniem, jeśli użytkownik naciska Nasłuchiwanie i próbujesz ustawić Listen na wartość False. Jeśli jednak użytkownik zwolnił nasłuchiwania i tryb nasłuchiwania nie przekroczył limitu czasu, powiedzie się.

nasłuchiwanie również kończy się niepowodzeniem, jeśli nie ma dostępnego zgodnego aparatu mowy zgodnego z ustawieniem LanguageID znaku, użytkownik wyłączył wprowadzanie mowy przy użyciu arkusza właściwości programu Microsoft Agent lub urządzenie audio jest zajęte.

Po pomyślnym ustawieniu tej metody na wartość Trueserwer wyzwala zdarzenie ListenStart. Serwer wysyła ListenComplete po przekroczeniu limitu czasu trybu nasłuchiwania lub po ustawieniu Nasłuchiwanie na wartość False.

Ta metoda nie wywołuje automatycznie Zatrzymaj i odtwarza animację stanu nasłuchiwania, ponieważ serwer działa po naciśnięciu nasłuchiwania. Dzięki temu można określić, czy przerwać bieżącą animację przy użyciu animacji ListenStart, wywołując stop i odtwarzając własną odpowiednią animację. Jednak serwer wywołuje Stop i odtwarza animację stanu słuchu po wykryciu wypowiedzi użytkownika.

Zobacz też

właściwości LanguageID, ListenComplete event, ListenStart event