Événement de commande

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

Description

Se produit lorsque l'utilisateur choisit une commande (du client).

Syntaxe

Sub agent_Command (ByVal UserInput**)**

Élément

Description

UserInput

Identifie l'objet Command renvoyé par le serveur. Les propriétés suivantes sont accessibles à partir de l'objet Command : CharacterID Chaîne de caractères identifiant le nom (ID) du personnage qui a reçu la commande. Nom Chaîne de caractères identifiant le nom (ID) de la commande. Confiance Valeur entière longue indiquant le score de confiance pour la commande. Voix Une chaîne de caractères identifiant le texte vocal de la commande. Alt1Name Une chaîne de caractères identifiant le nom de la prochaine (deuxième) meilleure commande. Alt1Confidence Valeur entière longue indiquant le score de confiance de la (deuxième) meilleure commande suivante. Alt1Voice Une chaîne de caractères identifiant le texte vocal de la meilleure commande alternative suivante. Alt2Name Chaîne de caractères indiquant le nom de la troisième meilleure commande. Alt2Confidence Nombre entier long indiquant le score de confiance pour la troisième meilleure correspondance de commande. Alt2Voice Une chaîne de caractères identifiant le texte de la voix pour la troisième meilleure commande. Count Alt2Voice Valeur entière longue indiquant le nombre d'alternatives renvoyées.

Notes

Le serveur vous notifie cet événement lorsque votre application est active au niveau de la saisie et que l'utilisateur choisit une commande par saisie vocale ou par le menu contextuel du caractère. L'événement renvoie le nombre de commandes correspondantes possibles dans Count ainsi que le nom, le score de confiance et le texte vocal de ces correspondances.

Si l'entrée vocale déclenche cet événement, le serveur renvoie une chaîne qui identifie la meilleure correspondance dans le paramètre Nom, et les deuxième et troisième meilleures correspondances dans les paramètres Alt1Name et Alt2Name. Une chaîne vide indique que l'entrée ne correspond à aucune commande définie par votre application ; par exemple, il peut s'agir d'une commande définie par le serveur. Si la commande correspond à la commande de l'agent, par exemple Hide, une chaîne vide sera renvoyée dans le paramètre Name, mais vous recevrez toujours le texte entendu dans le paramètre Voice.

Il est possible que le même nom de commande soit renvoyé dans plusieurs entrées. Les paramètres Confidence, Alt1Confidence , et Alt2Confidence renvoient les scores relatifs, compris entre -100 et 100, qui sont renvoyés par le moteur de reconnaissance vocale pour chaque correspondance respective. Les paramètres Voice, Alt1Voice , et Alt2Voice renvoient la synthèse vocale obtenue par le moteur de reconnaissance vocale pour chaque alternative. Si Count renvoie zéro (0), le serveur a détecté une entrée vocale, mais a déterminé qu'il n'y avait pas de commande correspondante.

Si la saisie vocale n'est pas la source de la commande, par exemple si l'utilisateur a sélectionné la commande dans le menu contextuel du personnage, le serveur renvoie le nom (ID) de la commande sélectionnée dans la propriété Name. Il renvoie également la valeur du paramètre Confidence, à savoir 100, et la valeur des paramètres Voice, à savoir la chaîne vide (""). Alt1Name et Alt2Name renvoient également des chaînes vides. Alt1Confidence et Alt2Confidence renvoient zéro (0), et Alt1Voice et Alt2Voice renvoient des chaînes vides. Count renvoie 1.

Remarque

Tous les moteurs de reconnaissance vocale ne renvoient pas nécessairement toutes les valeurs pour tous les paramètres de cet événement. Vérifiez auprès du fournisseur de votre moteur si celui-ci prend en charge l'interface Microsoft Speech API pour renvoyer les alternatives et les scores de confiance.