SRModeID, propriété

  • Article

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

Description

Renvoie ou définit le moteur de reconnaissance vocale utilisé par le caractère.

Syntaxe

agent**. Characters(« CharacterID »). SRModeID** [ = ModeID]

Élément 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 speech dans votre code.

Si vous spécifiez un ID de mode pour un moteur vocal qui n’est pas installé, si l’utilisateur a désactivé la reconnaissance vocale (dans la feuille des propriétés de Microsoft Agent) ou si la langue du moteur vocal 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 déjà défini (correctement) 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 le LanguageID 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 nécessite pas que SpeechInput.Enabled soit défini sur 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ées), l’interrogation ou la définition de cette propriété charge le moteur associé (s’il n’est pas déjà chargé) et démarre les services vocaux. Autrement dit, la clé d’écoute est disponible et l’info-bulle d’écoute peut être affichée. (La touche d’écoute et le conseil d’écoute ne sont activés que 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 à 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.

Les exigences du moteur speech 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.

Notes

Cette propriété renvoie également la chaîne vide si aucune prise en charge audio 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 chargement du moteur speech prend un temps anormalement long, vous pouvez obtenir une erreur indiquant que la requête a expiré.

 

Voir aussi

Propriété LanguageID