Listen, méthode

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

Description

Active le mode d’écoute (reconnaissance vocale) pour une période de temps.

Syntaxe

Agent. Personnages (« CharacterID »). Écouter** État

Élément	Description
State	Obligatoire. Valeur booléenne qui détermine s’il faut activer ou désactiver le mode d’écoute. Vrai Active le mode d’écoute. Faux Désactive le mode d’écoute.

Notes

La définition de 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’attente. Si vous (ou un autre client) avez correctement défini le mode d’écoute sur et que vous essayez de définir cette propriété sur True avant l’expiration du délai d’attente, 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 É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 input-active et si les services speech ont été démarrés. Pour vous assurer que les services vocaux ont été démarrés, interrogez ou définissez le SRModeID ou définissez le paramètre Voix pour une commande avant d’appeler Listen , sinon la méthode échoue. Pour détecter la réussite de cette méthode, appelez-la en tant que fonction et retourne 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 Écoute et que vous essayez 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.

L’écoute échoue également s’il n’existe aucun moteur vocal compatible qui correspond au paramètre LanguageID du caractère, si l’utilisateur a désactivé l’entrée vocale à l’aide de la feuille des propriétés de Microsoft Agent ou si le périphérique audio est occupé.

Lorsque vous définissez correctement cette méthode sur True, le serveur déclenche l’événement ListenStart . Le serveur envoie ListenComplete lorsque le délai d’attente 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 Écoute est enfoncée. Cela vous permet de déterminer s’il faut interrompre l’animation en cours à l’aide de l’animation ListenStart en appelant Stop et en lisant votre propre animation appropriée. Toutefois, le serveur appelle Stop et lit une animation d’état de l’audition lorsqu’un énoncé utilisateur est détecté.

Voir aussi

Propriété LanguageID, événement ListenComplete, événement ListenStart