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 de

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

sintaxis

agente de .caracteres ("characterID"). de estado de escucha**

Parte	Descripción
de estado de	Obligatorio. 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 (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 Escucha, 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 tecla De 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 elSRModeID deo establezca el valor de Voice para un comando de antes de llamar a escuchar 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

El método también produce un error si el usuario presiona la tecla Escuchando e intenta establecer Listen en False. Sin embargo, si el usuario ha publicado la tecla de escucha y el modo de escucha no ha agotado el tiempo de espera, se realizará correctamente.

escucha también se produce un error 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 del Agente de Microsoft 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 de escucha en False.

Este método no llama automáticamente a Stop y reproduce una animación de estado de escucha como hace el servidor cuando se presiona la tecla 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 Detener 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