Listen-Methode

[Microsoft Agent ist ab Windows 7 veraltet und in nachfolgenden Versionen von Windows möglicherweise nicht verfügbar.]

Beschreibung

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

Syntax

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

Teil	Beschreibung
Zustand	Erforderlich. Ein boolescher Wert, der bestimmt, ob der Lauschmodus aktiviert oder deaktiviert werden soll. STIMMT Aktiviert den Lauschmodus. FALSE Deaktiviert den Lauschmodus.

Bemerkungen

Wenn Sie diese Methode auf True festlegen, wird der Lauschmodus (aktiviert die Spracherkennung) für einen festen Zeitraum (10 Sekunden) aktiviert. Während Sie den Wert des Timeouts nicht festlegen können, können Sie den Lauschmodus deaktivieren, bevor das Timeout abläuft. Wenn Sie (oder ein anderer Client) den Lauschmodus erfolgreich aktiviert haben und versuchen, diese Eigenschaft auf True festzulegen, bevor das Timeout abläuft, wird die Methode erfolgreich ausgeführt und das Timeout zurückgesetzt. Wenn der Lauschmodus jedoch aktiviert ist, weil der Benutzer die Lauschtaste drückt, ist die Methode erfolgreich, aber das Timeout wird ignoriert, und der Lauschmodus endet basierend auf der Interaktion des Benutzers mit der Listening-Taste.

Diese Methode ist nur erfolgreich, wenn sie vom eingabeaktiven Client aufgerufen wird und wenn Sprachdienste gestartet wurden. Um sicherzustellen, dass Sprachdienste gestartet wurden, abfragen oder festlegen Sie die SRModeID , oder legen Sie die Spracheinstellung für einen Befehl 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 es wird ein boolescher Wert zurückgegeben, 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 Taste Listening drückt und Sie versuchen, Listen auf False festzulegen. Wenn der Benutzer jedoch die Lauschtaste freigegeben hat und das Zeitlimit für den Lauschmodus nicht abgelaufen ist, ist dies erfolgreich.

Außerdem schlägt Listen fehl, wenn keine kompatible Sprach-Engine verfügbar ist, die der LanguageID-Einstellung des Zeichens entspricht, der Benutzer die Spracheingabe mithilfe des Microsoft Agent-Eigenschaftenblatts deaktiviert hat oder das Audiogerät ausgelastet ist.

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

Diese Methode ruft nicht automatisch beenden und eine Animation zum Lauschenzustand ab, wie es der Server tut, wenn die Lauschtaste gedrückt wird. Dadurch können Sie bestimmen, ob die aktuelle Animation mithilfe der ListenStart-Animation unterbrochen werden soll, indem Sie Stop aufrufen und Ihre eigene entsprechende Animation wiedergeben. Der Server ruft jedoch Beenden auf und gibt eine Animation zum Hören des Zustands ab, wenn eine Benutzeräußerung erkannt wird.

Weitere Informationen

LanguageID-Eigenschaft, ListenComplete-Ereignis, ListenStart-Ereignis