Partager via

IAgentCharacterEx::SetsRModeID

  • Article

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

HRESULT SetSRModeID(
   BSTR bszModeID  // speech recognition engine ID
);

Définit l’ID de mode du moteur de reconnaissance vocale défini pour le caractère.

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

bszModeID

Paramètre d’ID de mode du moteur de reconnaissance vocale pour le caractère.

Ce paramètre définit le moteur pour l’entrée vocale d’un caractère. L’ID de mode d’un moteur de reconnaissance vocale est le GUID défini par le fournisseur de reconnaissance vocale qui identifie de manière unique le mode du moteur (mis en forme avec des accolades et des tirets). Pour plus d’informations, consultez la documentation du Kit de développement logiciel (SDK) Microsoft Speech.

Si vous spécifiez un ID de mode qui ne correspond pas au paramètre de langue du caractère, si l’utilisateur a désactivé la reconnaissance vocale (dans la feuille de propriétés de Microsoft Agent) ou si le moteur n’est pas installé, cet appel échoue. Si vous ne définissez pas d’ID de mode du moteur de reconnaissance vocale pour le caractère, le serveur en définit un qui correspond au paramètre de langue du caractère (à l’aide des interfaces de l’API Microsoft Speech).

Lorsque l’entrée vocale est activée dans la feuille de propriétés agent (Options de caractères avancées), la définition de cette propriété charge le moteur associé (si elle n’est pas déjà chargée) et démarre les services vocaux. Autrement dit, la clé d’écoute est disponible et le conseil d’écoute peut être affiché. (La touche d’écoute et le conseil d’écoute sont activés uniquement s’ils sont également activés dans Options de caractères avancés.) Toutefois, si vous interrogez la propriété lorsque la reconnaissance vocale est désactivée, le serveur ne démarre pas les services speech.

Cette propriété s’applique uniquement au client du caractère ; le paramètre ne reflète pas le paramètre pour les autres clients du caractère ou d’autres caractères du client.

Les exigences du moteur vocal de Microsoft Agent sont basées sur l’API Microsoft Speech. Les moteurs prenant en charge les exigences SAPI de Microsoft Agent peuvent être installés et utilisés avec Agent.

Voir aussi

IAgentCharacterEx::GetsRModeID