Propriété SRModeID
[Microsoft Agent est déconseillé à partir de Windows 7 et peut ne pas être disponible dans les versions ultérieures de Windows.]
-
Descriptive
-
Retourne ou définit le moteur de reconnaissance vocale utilisé par le caractère.
-
Stockéesyntaxe
-
*agent . Caractères («CharacterID»). SRModeID * [ = ModeID]
Partie Description ModeID Expression de chaîne qui correspond à l’ID de mode d’un moteur de reconnaissance vocale.
Notes
La propriété détermine le moteur de reconnaissance vocale utilisé par le caractère pour l’entrée vocale. L’ID de mode d’un moteur de reconnaissance vocale est une chaîne mise en forme définie par le fournisseur de reconnaissance vocale qui identifie le moteur de manière unique. Pour plus d’informations, consultez accès à un moteur de reconnaissance vocale dans votre code.
Si vous spécifiez un ID de mode pour un moteur de reconnaissance vocale qui n’est pas installé, si l’utilisateur a désactivé la reconnaissance vocale (dans la feuille de propriétés de l’agent Microsoft), ou si la langue du moteur de reconnaissance vocale spécifié ne correspond pas au paramètre LanguageID du caractère, le serveur génère une erreur.
Si vous interrogez cette propriété et que vous n’avez pas encore défini le moteur de reconnaissance vocale, le serveur retourne l’ID de mode du moteur que SAPI retourne en fonction du paramètre LanguageID du caractère. Si vous n’avez pas défini l’ID de langue du caractère, agent retourne l’ID de mode du moteur que SAPI retourne en fonction du paramètre d’ID de langue par défaut de l’utilisateur. S’il n’existe aucun moteur correspondant, le serveur retourne une chaîne vide (""). L’interrogation de cette propriété ne requiert pas que SpeechInput. Enabled ait la valeur true. Toutefois, si vous interrogez la propriété lorsque l’entrée vocale est désactivée, le serveur retourne une chaîne vide.
Lorsque l’entrée vocale est activée (dans la fenêtre Options de caractères avancés), l’interrogation ou la définition de cette propriété chargera le moteur associé (s’il n’est pas déjà chargé) et démarrera les services de reconnaissance vocale. 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 à l’utilisation du caractère par votre application cliente ; le paramètre n’affecte pas les autres clients du caractère ou d’autres caractères de votre application cliente.
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.
Notes
Cette propriété retourne également la chaîne vide si aucune prise en charge de son compatible n’est installée sur votre système.
Notes
L’interrogation de cette propriété ne retourne généralement pas d’erreur. Toutefois, si le temps de chargement du moteur de reconnaissance vocale est anormalement long, vous pouvez obtenir une erreur indiquant que la requête a expiré.