Partager via

IAgentUserInput::GetAllItemData

  • Article

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

HRESULT GetAllItemData(
   VARIANT * pdwItemIndices,  // address of variable for alternative IDs
   VARIANT * plConfidences,   // address of variable for confidence scores
   VARIANT * pbszText         // address of variable for voice text
);

Récupère les données de toutes les alternatives command passées à un rappel IAgentNotifySink::Command .

  • Retourne S_OK pour indiquer que l’opération a réussi.

pdwItemIndices

Adresse d’une variable qui reçoit les ID de commandes passés au rappel IAgentNotifySink::Command .

plConfidences

Adresse d’une variable qui reçoit les scores de confiance pour les alternatives de commande passées au rappel IAgentNotifySink::Command .

pbszText

Adresse d’une variable qui reçoit le texte vocal pour les alternatives de commande passées au rappel IAgentNotifySink::Command .

Si l’entrée vocale déclenche IAgentNotifySink::Command, le serveur retourne la meilleure correspondance, la deuxième meilleure correspondance et la troisième meilleure correspondance, si elles sont fournies par le moteur de reconnaissance vocale. Il fournit les scores de confiance relatifs, dans la plage de -100 à 100, et le texte réel « entendu » par le moteur de reconnaissance vocale. Si la meilleure correspondance était une commande fournie par le serveur, le serveur envoie un ID NULL, mais envoie toujours un score de confiance et le texte Voix .

Si l’entrée vocale n’était pas la source de l’événement ; Par exemple, si l’utilisateur a sélectionné la commande dans le menu contextuel du caractère, le serveur Microsoft Agent retourne l’ID de la commande sélectionnée, avec un score de confiance de 100 et un texte vocal null. Les autres alternatives retournent comme NULL avec des scores de confiance de zéro (0) et du texte vocal comme NULL.

Notes

Tous les moteurs de reconnaissance vocale ne peuvent pas retourner toutes les valeurs de tous les paramètres de cet événement. Contactez votre fournisseur de moteur pour déterminer si le moteur prend en charge l’interface de l’API Microsoft Speech pour retourner des alternatives et des scores de confiance.

 

Voir aussi

IAgentUserInput::GetItemConfidence, IAgentUserInput::GetItemText, IAgentUserInput::GetItemID