Partager via


TTSModeID, propriété

[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 mode de moteur TTS utilisé pour le caractère.

Syntaxe

agent**. Caractères (« CharacterID »). TTSModeID** [ = ModeID]

Élément Description
ModeID Expression de chaîne qui correspond à l’ID de mode d’un moteur de reconnaissance vocale.

 

Notes

Cette propriété détermine l’ID du mode moteur TTS (synthèse vocale) pour la sortie parlée d’un caractère. L’ID de mode d’un moteur TTS est une chaîne mise en forme définie par le fournisseur de reconnaissance vocale qui identifie de manière unique le mode du moteur. Pour plus d’informations, consultez Accès à un moteur Speech dans votre code.

La définition de cette propriété remplace la tentative du serveur de charger un moteur en fonction du paramètre TTS compilé du caractère et du paramètre LanguageID actuel du caractère. Toutefois, si vous spécifiez un ID de mode pour un moteur qui n’est pas installé ou si l’utilisateur a désactivé la sortie vocale dans la feuille des propriétés de Microsoft Agent (AudioOutput.Enabled = False), le serveur génère une erreur.

Si vous ne définissez pas (ou n’avez pas réussi) d’ID de mode TTS pour le caractère, le serveur vérifie si le paramètre de mode TTS compilé du caractère correspond au paramètre LanguageID du caractère et que le moteur TTS associé est installé. Si c’est le cas, le mode TTS utilisé par le caractère pour la sortie parlée et cette propriété retourne cet ID de mode. Si ce n’est pas le cas, le serveur demande un moteur vocal SAPI compatible qui correspond au LanguageID du caractère, ainsi que le sexe et l’âge définis pour l’ID de mode compilé du caractère. Si vous n’avez pas défini languageID du caractère, son LanguageID est la langue de l’utilisateur actuel. Si aucun moteur correspondant n’est trouvé, l’interrogation de cette propriété renvoie une chaîne vide pour l’ID de mode du moteur. De même, si vous interrogez cette propriété lorsque l’utilisateur a désactivé la sortie vocale dans la feuille des propriétés de Microsoft Agent (AudioOutput.Enabled = False), la valeur est une chaîne vide.

L’interrogation ou la définition de cette propriété charge le moteur associé (s’il n’est pas déjà chargé). Toutefois, si le moteur spécifié dans le paramètre TTS compilé du caractère est installé et correspond au paramètre d’ID de langue du caractère, le moteur est chargé lors du chargement du caractère.

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

La définition du TTSModeID peut échouer si Speech.dll n’est pas installé et que le moteur que vous spécifiez ne correspond pas au paramètre de mode TTS compilé du caractère.

 

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