IAgentCharacterEx::SetSRModeID

[Microsoft Agent est déconseillé à partir de Windows 7 et peut ne pas être disponible 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 _ la valeur S OK pour indiquer que l’opération a réussi.

bszModeID

Paramètre de l’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 façon unique le mode du moteur (mis en forme à l’aide d’accolades et de 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 l’agent Microsoft) ou si le moteur n’est pas installé, cet appel échoue. Si vous ne définissez pas un ID de mode de moteur de reconnaissance vocale pour le caractère, le serveur définit celui 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 de l’agent (options de caractères avancés), la définition de cette propriété chargera le moteur associé (s’il n’est pas déjà chargé) et démarrez les services vocaux. Autrement dit, la clé d’écoute est disponible et l’info-bulle d’écoute est affichable. (La clé d’écoute et l’info-bulle d’écoute sont activées uniquement si elles sont également activées dans les options de caractères avancés.) Toutefois, si vous interrogez la propriété alors que la reconnaissance vocale est désactivée, le serveur ne démarre pas les services vocaux.

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

La configuration requise du moteur de reconnaissance vocale de Microsoft Agent est basée sur l’API Microsoft Speech. Les moteurs prenant en charge les spécifications SAPI de Microsoft Agent peuvent être installés et utilisés avec l’agent.

Voir aussi

IAgentCharacterEx::GetSRModeID