Listen-Methode

[Der Microsoft-Agent ist ab Windows 7 veraltet und kann in nachfolgenden Versionen von Windows nicht verfügbar sein.]

Beschreibung

Aktiviert den Überwachungsmodus (Spracherkennung) für einen bestimmten Zeitraum.

Syntax

Agent.Zeichen("CharacterID"). Listen** State

Teil	Beschreibung
State	Erforderlich. Ein boolescher Wert, der bestimmt, ob der Überwachungsmodus aktiviert oder deaktiviert werden soll. True aktiviert den Überwachungsmodus. False deaktiviert den Überwachungsmodus.

Bemerkungen

Wenn Sie diese Methode auf "True" festlegen aktiviert den Überwachungsmodus (aktiviert die Spracherkennung) für einen festen Zeitraum (10 Sekunden). Obwohl Sie den Wert des Timeouts nicht festlegen können, können Sie den Überwachungsmodus deaktivieren, bevor das Timeout abläuft. Wenn Sie (oder ein anderer Client) den Überwachungsmodus erfolgreich festlegen und versuchen, diese Eigenschaft auf True festzulegen, bevor das Timeout abläuft, wird die Methode erfolgreich ausgeführt und setzt das Timeout zurück. Wenn der Überwachungsmodus jedoch aktiviert ist, weil der Benutzer die Zuhören-Taste drückt, ist die Methode erfolgreich, aber das Timeout wird ignoriert, und der Überwachungsmodus endet basierend auf der Interaktion des Benutzers mit der Überwachungsschlüssel.

Diese Methode ist nur erfolgreich, wenn der eingabeaktive Client aufgerufen wird und wenn Sprachdienste gestartet wurden. Um sicherzustellen, dass Sprachdienste gestartet wurden, fragen Sie die SRModeID- ab, oder legen Sie die Einstellung Voice für eine Command- fest, bevor Sie Listen- aufrufen, andernfalls schlägt die Methode fehl. Um den Erfolg dieser Methode zu erkennen, rufen Sie sie als Funktion auf, und sie gibt einen booleschen Wert zurück, der angibt, ob die Methode erfolgreich war.

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

   Else
      ' The method failed

   End If

Die Methode schlägt auch fehl, wenn der Benutzer die Zuhören-Taste drückt, und Sie versuchen, Listen- auf Falsefestzulegen. Wenn der Benutzer jedoch die Hörtaste freigegeben hat und der Überwachungsmodus nicht abgelaufen ist, ist es erfolgreich.

Listen schlägt auch fehl, wenn kein kompatibles Sprachmodul verfügbar ist, das mit der Einstellung LanguageID des Zeichens übereinstimmt, der Benutzer die Spracheingabe mithilfe des Microsoft Agent-Eigenschaftenblatts deaktiviert hat oder das Audiogerät ausgelastet ist.

Wenn Sie diese Methode erfolgreich auf Truefestlegen, löst der Server das ListenStart--Ereignis aus. Der Server sendet ListenComplete-, wenn das Timeout des Überwachungsmodus abgeschlossen ist oder wenn Sie Listen- auf "False"festlegen.

Diese Methode ruft nicht automatisch Stop auf und gibt eine Überwachungszustandsanimation wieder, wie der Server ausgeführt wird, wenn die Hörtaste gedrückt wird. Auf diese Weise können Sie ermitteln, ob die aktuelle Animation mithilfe der ListenStart- Animation unterbrochen werden soll, indem Sie Beenden aufrufen und ihre eigene geeignete Animation wiedergeben. Der Server ruft jedoch Stop auf und gibt eine Hörzustandsanimation wieder, wenn ein Benutzer festgestellt wird.

Siehe auch

LanguageID-Eigenschaft, ListenComplete-Ereignis, ListenStart-Ereignis