Skip to main content
Configura el perfil que se usará para un tipo especificado de operación de texto a voz.

Sintaxis

Parámetros

type   PartySynthesizeTextToSpeechType El tipo de operaciones de texto a voz para las que debe usarse el perfil especificado. profileIdentifier   PartyString El identificador del perfil que deben usar las operaciones de texto a voz del tipo especificado. asyncIdentifier   void*
opcional
Un valor de contexto opcional del tamaño de un puntero, definido por la aplicación, que se puede usar para asociar el cambio de estado de finalización con esta llamada.

Valor devuelto

PartyError c_partyErrorSuccess si la operación asincrónica para establecer el perfil de texto a voz comenzó, o un código de error en caso contrario. Si este método produce un error, no se generará ningún cambio de estado relacionado. La forma legible del código de error se puede recuperar mediante PartyManager::GetErrorMessage().

Comentarios

El perfil proporcionado se usa para todas las llamadas posteriores a SynthesizeTextToSpeech() que especifiquen el mismo valor para type. No se configura ningún perfil hasta que se llama a SetTextToSpeechProfile() al menos una vez. Por lo tanto, este método debe llamarse al menos una vez antes de que cualquier llamada a SynthesizeTextToSpeech() se realice correctamente.

Este método acepta un identificador de perfil para indicar la selección del perfil, de modo que los títulos puedan pasar el resultado de PartyTextToSpeechProfile::GetIdentifier() o proporcionar un identificador de perfil almacenado en caché de una sesión anterior de la biblioteca Party.

Se pueden iniciar varias operaciones SetTextToSpeechProfile(), que se ponen en cola de forma asincrónica. Cada operación se procesa y se completa en orden.

Se trata de una operación asincrónica; se proporciona un PartySetTextToSpeechProfileCompletedStateChange mediante PartyManager::StartProcessingStateChanges() al completarse.

La funcionalidad de síntesis de texto a voz usa internamente las estimaciones disponibles de región y de medición de latencia para optimizar el uso del servicio. Si la opción PartyOption::RegionUpdateConfiguration se usó para configurar un modo de actualización de PartyRegionUpdateMode::Deferred, es posible que la recuperación del conjunto de regiones disponibles y la medición de la calidad de la conexión a estas aún no hayan comenzado, o que la última actualización haya superado la antigüedad del intervalo de actualización configurado. Si el dispositivo local no se está conectando actualmente ni está conectado a ninguna red, SetTextToSpeechProfile() garantiza que cualquier actualización de región diferida haya comenzado y que el PartyRegionsChangedStateChange asociado se proporcione antes de la finalización del PartySetTextToSpeechProfileCompletedStateChange de esta llamada.

Requisitos

Encabezado: Party.h

Consulte también

PartyLocalChatControl
PartyLocalChatControl::GetTextToSpeechProfile
Última modificación el 28 de agosto de 2026