Événements d’entrée vocale
[Microsoft Agent est déconseillé à partir de Windows 7 et peut être indisponible dans les versions ultérieures de Windows.]
En plus de la notification d’événement Command , Agent avertit également le client actif d’entrée lorsque le serveur active ou désactive le mode d’écoute, à l’aide des événements ListenStart et ListenComplete (IAgentNotifySinkEx::ListeningState). Toutefois, si l’utilisateur appuie sur la touche Mode d’écoute et qu’aucun moteur de reconnaissance vocale correspondant n’est disponible pour le caractère le plus élevé du client actif d’entrée, le serveur démarre le délai d’expiration du mode de raccourci d’écoute, mais ne génère pas d’événement ListenStart pour le client actif du caractère. Si, avant la fin du délai d’expiration, l’utilisateur active un autre caractère avec la prise en charge du moteur de reconnaissance vocale, le serveur tente d’activer l’entrée vocale et génère l’événement ListenStart .
De même, si un client tente d’activer le mode d’écoute à l’aide de la méthode Listen et qu’aucun moteur de reconnaissance vocale correspondant n’est disponible, l’appel échoue et le serveur ne génère pas d’événement ListenStart. Dans le contrôle Agent Microsoft, la méthode Listen retourne False, mais l’appel ne génère pas d’erreur.
Lorsque le mode de touche d’écoute est activé et que l’utilisateur bascule vers un caractère qui utilise un autre moteur de reconnaissance vocale, le serveur bascule vers et active ce moteur et déclenche un événement ListenComplete , puis un événement ListenStart . Si le caractère activé n’a pas de moteur de reconnaissance vocale disponible (parce qu’il n’en est pas installé ou qu’aucun ne correspond au paramètre d’ID de langue du caractère activé), le serveur déclenche l’événement ListenComplete pour le caractère précédemment activé et transmet une valeur dans le paramètre Cause . Toutefois, le serveur ne génère pas d’événements ListenStart ou ListenComplete pour les clients qui n’ont pas de prise en charge de la reconnaissance vocale.
Si un client appelle correctement la méthode Listen et qu’un caractère sans prise en charge du moteur de reconnaissance vocale devient actif avant la fin du délai d’expiration du mode d’écoute, puis que l’utilisateur revient au caractère du client d’origine, le serveur génère un événement ListenStart pour ce client.
Si le client actif en entrée change les moteurs de reconnaissance vocale en modifiant SRModeID en mode Écoute, le serveur bascule vers et active ce moteur sans réactiver l’événement ListenStart . Toutefois, si le moteur spécifié n’est pas disponible, l’appel échoue (génère une erreur dans le contrôle) et le serveur appelle également l’événement ListenComplete .