Syntaxe
Paramètres
type PartySynthesizeTextToSpeechType
Le type d’opérations de synthèse vocale pour lequel le profil spécifié doit être utilisé.
profileIdentifier PartyString
L’identificateur du profil que les opérations de synthèse vocale du type spécifié doivent utiliser.
asyncIdentifier void*optional Une valeur de contexte facultative de la taille d’un pointeur, définie par l’application, qui peut être utilisée pour associer le changement d’état de fin à cet appel.
Valeur renvoyée
PartyErrorc_partyErrorSuccess si l’opération asynchrone de définition du profil de synthèse vocale a commencé ; sinon, un code d’erreur. Si cette méthode échoue, aucun changement d’état associé n’est généré. La forme lisible du code d’erreur peut être obtenue via PartyManager::GetErrorMessage().
Remarques
Le profil fourni est utilisé pour tous les appels ultérieurs à SynthesizeTextToSpeech() qui spécifient la même valeur pourtype. Aucun profil n’est configuré tant que SetTextToSpeechProfile() n’a pas été appelée au moins une fois. Cette méthode doit donc être appelée au moins une fois avant que les appels à SynthesizeTextToSpeech() puissent réussir. Cette méthode accepte un identificateur de profil pour indiquer la sélection du profil, afin que les titres puissent soit transmettre le résultat de PartyTextToSpeechProfile::GetIdentifier(), soit fournir un identificateur de profil mis en cache lors d’une session précédente de la bibliothèque Party.
Plusieurs opérations SetTextToSpeechProfile() peuvent être lancées ; elles sont mises en file d’attente de manière asynchrone. Chaque opération est traitée et terminée dans l’ordre.
Il s’agit d’une opération asynchrone ; un PartySetTextToSpeechProfileCompletedStateChange est fourni via PartyManager::StartProcessingStateChanges() à la fin de l’opération.
La fonctionnalité de synthèse vocale utilise en interne les estimations de régions disponibles et de mesures de latence pour optimiser l’utilisation du service. Si l’option PartyOption::RegionUpdateConfiguration a été utilisée pour configurer un mode de mise à jour PartyRegionUpdateMode::Deferred, la récupération de l’ensemble des régions disponibles et la mesure de la qualité de connexion à celles-ci n’ont peut-être pas encore commencé, ou la dernière mise à jour a peut-être dépassé l’ancienneté d’intervalle d’actualisation configurée. Si l’appareil local n’est actuellement ni en cours de connexion ni connecté à un réseau, SetTextToSpeechProfile() garantit que toute mise à jour différée des régions a commencé et que le PartyRegionsChangedStateChange associé est fourni avant la fin de cet appel, signalée par le PartySetTextToSpeechProfileCompletedStateChange.
Configuration requise
En-tête : Party.hVoir aussi
PartyLocalChatControlPartyLocalChatControl::GetTextToSpeechProfile