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.

Syntax

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

Parte	Descripción
Estado	Necesario. 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.

Observaciones

Establecer este método en True permite 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 y 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 De 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 clave de escucha.

Este método solo se realiza correctamente cuando el cliente de entrada-activo llama 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ámalo 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

El método también produce un error si el usuario presiona la tecla De escucha 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 De escucha. Esto le permite determinar si interrumpir la animación actual mediante la animación ListenStart llamando a Stop y reproduciendo su 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.

Consulte también

Propiedad LanguageID, evento ListenComplete, evento ListenStart