Listen, méthode

[Microsoft Agent est déconseillé à partir de Windows 7 et peut être indisponible dans les versions ultérieures de Windows.]

Description

Active le mode d’écoute (reconnaissance vocale) pendant une période prolongée.

syntaxe

agent.Caractères( »CharacterID« ). Écouter** d’état

Partie	Description
d’état	Obligatoire. Valeur booléenne qui détermine s’il faut activer ou désactiver le mode d’écoute. True active le mode d’écoute. False désactive le mode d’écoute.

Remarques

Définir cette méthode sur True active le mode d’écoute (active la reconnaissance vocale) pendant une période fixe (10 secondes). Bien que vous ne puissiez pas définir la valeur du délai d’attente, vous pouvez désactiver le mode d’écoute avant l’expiration du délai d’expiration. Si vous (ou un autre client) avez correctement défini le mode d’écoute et que vous tentez de définir cette propriété sur True avant l’expiration du délai d’expiration, la méthode réussit et réinitialise le délai d’attente. Toutefois, si le mode d’écoute est activé parce que l’utilisateur appuie sur la touche d’écoute, la méthode réussit, mais le délai d’attente est ignoré et le mode d’écoute se termine en fonction de l’interaction de l’utilisateur avec la clé d’écoute.

Cette méthode réussit uniquement lorsqu’elle est appelée par le client actif d’entrée et si les services speech ont été démarrés. Pour vous assurer que les services speech ont été démarrés, interrogez ou définissez l'SRModeIDou définissez le paramètreVoicepour une Command avant d’appeler Listen sinon la méthode échouera. Pour détecter la réussite de cette méthode, appelez-la en tant que fonction et retournez une valeur booléenne indiquant si la méthode a réussi.

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

   Else
      ' The method failed

   End If

La méthode échoue également si l’utilisateur appuie sur la touche d’écoute et que vous tentez de définir Écouter sur False. Toutefois, si l’utilisateur a libéré la clé d’écoute et que le mode d’écoute n’a pas expiré, il réussit.

d’écoute échoue également s’il n’existe aucun moteur de reconnaissance vocale compatible disponible qui correspond au paramètre LanguageID du caractère, que l’utilisateur a désactivé l’entrée vocale à l’aide de la feuille de propriétés Microsoft Agent ou que l’appareil audio est occupé.

Lorsque vous définissez cette méthode sur True, le serveur déclenche l’événementListenStart. Le serveur envoie listenComplete lorsque le délai d’expiration du mode d’écoute est terminé ou lorsque vous définissez écouter sur False.

Cette méthode n’appelle pas automatiquement Arrêter et lire une animation d’état d’écoute comme le fait le serveur lorsque la touche d’écoute est enfoncée. Cela vous permet de déterminer s’il faut interrompre l’animation actuelle à l’aide de l’animationListenStart en appelant Arrêter et en jouant votre propre animation appropriée. Toutefois, le serveur appelle Arrêter et lit une animation d’état d’audition lorsqu’un énoncé utilisateur est détecté.

Voir aussi

propriété LanguageID, d’événements ListenComplete , 'événement ListenStart