Método Listen

[Microsoft Agent está en desuso a partir 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

agent.Characters")("CharacterID"). Estado de * escucha

Parte Descripción
Estado Necesario. Valor booleano que determina si se debe activar o desactivar el modo de escucha. True Activa el modo de escucha.
False Desactiva el modo de escucha.

Observaciones

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) ha establecido 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á en porque el usuario presiona la tecla Escuchando, el método se realiza correctamente, pero se omite el tiempo de espera 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 lo llama el cliente activo de entrada 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 de voz para 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 ha correcto.

   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 Listening e intenta establecer Listen en False. Sin embargo, si el usuario ha liberado la clave de escucha y el modo de escucha no ha pasado el tiempo de espera, se realizará correctamente.

La escucha también produce un error si no hay ningún motor de voz compatible disponible que coincida con la configuración de LanguageID del carácter, si el usuario ha deshabilitado la entrada de voz mediante la hoja de propiedades de Microsoft Agent o si 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 and play a Listening state animation as the server does when the Listening key is pressed. Esto le permite determinar si se interrumpe la animación actual mediante la animación ListenStart mediante una llamada a Stop y la reproducción de su propia animación adecuada. Sin embargo, el servidor llama a Stop y reproduce una animación de estado de audiencia cuando se detecta una expresión del usuario.

Consulte también

Propiedad LanguageID, evento ListenComplete, evento ListenStart