Listen-Methode
[Microsoft Agent ist ab Version Windows 7 veraltet und möglicherweise in nachfolgenden Versionen von Windows.]
-
Beschreibung
-
Aktiviert den Lauschenmodus (Spracherkennung) für einen bestimmten Zeitraum.
-
Syntax
-
agent.Characters("CharacterID"). Lauschen des * Zustands
Teil Beschreibung Zustand Erforderlich. Ein boolescher Wert, der bestimmt, ob der Lauschmodus aktiviert oder deaktiviert werden soll. True Aktiviert den Lauschenmodus.
False Deaktiviert den Lauschenmodus.
Bemerkungen
Wenn Sie diese Methode auf True festlegen, wird der Lauschenmodus (aktiviert die Spracherkennung) für einen festen Zeitraum (10 Sekunden) aktiviert. Obwohl Sie den Wert des Time out nicht festlegen können, können Sie den Abhörmodus deaktivieren, bevor das Time out abläuft. Wenn Sie (oder ein anderer Client) den Abhörmodus erfolgreich auf festgelegt haben und versuchen, diese Eigenschaft auf True zu setzen, bevor das Time out abläuft, wird die Methode erfolgreich ausgeführt und das Time out zurückgesetzt. Wenn der Lauschen-Modus jedoch aktiviert ist, weil der Benutzer die Abhörtaste drückt, ist die Methode erfolgreich, aber das Time out wird ignoriert, und der Abhörmodus wird basierend auf der Interaktion des Benutzers mit der Abhörtaste beendet.
Diese Methode ist nur erfolgreich, wenn sie vom eingabeaktiven Client aufgerufen wird und die Sprachdienste gestartet wurden. Um sicherzustellen, dass Speech-Dienste gestartet wurden, fragen Sie die SRModeID ab, oder legen Sie sie fest, oder legen Sie die Spracheinstellung für einen Befehl fest, bevor Sie Lauschen aufrufen, da andernfalls die Methode fehlschlägt. Um den Erfolg dieser Methode zu erkennen, rufen Sie sie als Funktion auf und geben 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 Abhörtaste drückt und Sie versuchen, "Lauschen" auf "False" zu setzen. Wenn der Benutzer jedoch die Abhörtaste freigegeben hat und für den Lauschenmodus kein Time out erfolgt ist, ist dies erfolgreich.
Außerdem schlägt das Lauschen 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 Time out im Lauschenmodus abgeschlossen ist oder wenn Sie Lauschen auf False festlegen.
Diese Methode führt nicht automatisch den Aufruf stop and play a Listening state animation (Beenden und Wiederhören) aus, wie dies vom Server beim Drücken der Abhörtaste der Fall ist. Auf diese Weise können Sie bestimmen, ob die aktuelle Animation mithilfe der ListenStart-Animation unterbrochen werden soll, indem Sie Beenden aufrufen und Ihre eigene entsprechende Animation wieder geben. Der Server aufruft jedoch Stop und gibt eine Animation zum Hörzustand wieder, wenn eine Benutzeräußerung erkannt wird.
Weitere Informationen
LanguageID-Eigenschaft, ListenComplete-Ereignis, ListenStart-Ereignis