Listen (método)

[Microsoft Agent está en desuso a partir de Windows 7 y puede no estar disponible en versiones posteriores de Windows.]

Descripción

Activa el modo de escucha (reconocimiento de voz) durante un período de tiempo.

Sintaxis

Agente. Caracteres ("CharacterID"). Estado de escucha**

Parte Descripción
Estado Obligatorio. Valor booleano que determina si se va a activar o desactivar el modo de escucha. Verdad Activa el modo de escucha.
Falso Desactiva el modo de escucha.

Comentarios

Establecer este método en True habilita el modo de escucha (activa el reconocimiento de voz) durante un período fijo de tiempo (10 segundos). Aunque no puede establecer el valor del tiempo de espera, puede desactivar el modo de escucha antes de que expire el tiempo de espera. Si usted (u otro cliente) establece correctamente el modo de escucha en e intenta establecer esta propiedad en True antes de que expire el tiempo de espera, el método se realiza correctamente y restablece el tiempo de espera. Sin embargo, si el modo de escucha está activado porque el usuario presiona la tecla Escucha, el método se realiza correctamente, pero el tiempo de espera se omite y el modo de escucha finaliza en función de la interacción del usuario con la tecla Escucha.

Este método solo se realiza correctamente cuando lo llama el cliente de entrada-activo y si se han iniciado los servicios de voz. Para asegurarse de que se han iniciado los servicios de voz, consulte o establezca SRModeID o establezca la configuración voz de un comando antes de llamar a Listen ; de lo contrario, se producirá un error en el método. Para detectar el éxito de este método, llámelo como una función y devolverá un valor booleano que indica si el método se realizó correctamente.

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

   Else
      ' The method failed

   End If

También se produce un error en el método si el usuario está presionando la tecla Escuchando e intenta establecer Escuchar en False. Sin embargo, si el usuario ha liberado la clave de escucha y el modo de escucha no ha agotado el tiempo de espera, se realizará correctamente.

También se produce un error en la escucha si no hay ningún motor de voz compatible disponible que coincida con la configuración languageID del carácter, el usuario ha deshabilitado la entrada de voz mediante la hoja de propiedades de Microsoft Agent o el dispositivo de audio está ocupado.

Cuando se establece correctamente este método en True, el servidor desencadena el evento ListenStart . El servidor envía ListenComplete cuando se completa el tiempo de espera del modo de escucha o cuando se establece Escuchar en False.

Este método no llama automáticamente a Stop y reproduce una animación de estado de escucha, ya que el servidor hace cuando se presiona la tecla Escucha. Esto te permite determinar si interrumpir la animación actual mediante la animación ListenStart llamando a Stop y reproduciendo tu propia animación adecuada. Sin embargo, el servidor llama a Stop y reproduce una animación de estado de audición cuando se detecta una expresión de usuario.

Vea también

Propiedad LanguageID, evento ListenComplete, evento ListenStart