Partager via

IAgentCharacterEx::SetTTSModeID

  • Article

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

HRESULT SetTTSModeID(
   BSTR bszModeID  // TTS engine ID
);

Définit l’ID de mode du moteur TTS 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 TTS pour le caractère.

Notes

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

 

Ce paramètre détermine le mode moteur préféré pour la sortie TTS parlée d’un caractère. L’ID de mode d’un moteur TTS (text-to-speech) 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 définissez un ID de mode TTS, il remplace la tentative du serveur pour faire correspondre un moteur vocal en fonction de l’ID du mode TTS compilé du caractère, de l’ID de langue système actuelle et de l’ID de langue actuelle du caractère. Toutefois, si vous tentez de définir un ID de mode lorsque l’utilisateur a désactivé la sortie vocale dans la feuille de propriétés de Microsoft Agent ou lorsque le moteur associé n’est pas installé, cet appel échoue.

Si vous ne définissez pas d’ID de mode de moteur TTS pour le caractère, le serveur définit un moteur qui correspond au paramètre de langue du caractère (à l’aide des interfaces de l’API Microsoft Speech). La définition de cette propriété charge le moteur associé s’il n’est pas déjà chargé.

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 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:GetTTSModeID