Pular para o conteúdo principal
Configura o perfil a ser usado para um tipo especificado de operação de conversão de texto em fala.

Sintaxe

Parâmetros

type   PartySynthesizeTextToSpeechType O tipo de operações de conversão de texto em fala para o qual o perfil especificado deve ser usado. profileIdentifier   PartyString O identificador do perfil que as operações de conversão de texto em fala do tipo especificado devem usar. asyncIdentifier   void*
opcional
Um valor de contexto opcional, definido pelo aplicativo e do tamanho de um ponteiro, que pode ser usado para associar a alteração de estado de conclusão a esta chamada.

Valor retornado

PartyError c_partyErrorSuccess se a operação assíncrona para definir o perfil de conversão de texto em fala tiver sido iniciada ou um código de erro caso contrário. Se este método falhar, nenhuma alteração de estado relacionada será gerada. A forma legível do código de erro pode ser obtida por meio de PartyManager::GetErrorMessage().

Comentários

O perfil fornecido é usado em todas as chamadas subsequentes a SynthesizeTextToSpeech() que especifiquem o mesmo valor para type. Nenhum perfil é configurado até que SetTextToSpeechProfile() seja chamado pelo menos uma vez. Portanto, este método deve ser chamado pelo menos uma vez antes que qualquer chamada a SynthesizeTextToSpeech() tenha êxito.

Este método aceita um identificador de perfil para indicar a seleção do perfil, de modo que os títulos possam passar o resultado de PartyTextToSpeechProfile::GetIdentifier() ou fornecer um identificador de perfil armazenado em cache de uma sessão anterior da biblioteca do Party.

Várias operações SetTextToSpeechProfile() podem ser iniciadas, e elas são enfileiradas de forma assíncrona. Cada operação é processada e concluída em ordem.

Esta é uma operação assíncrona; um PartySetTextToSpeechProfileCompletedStateChange is provided via PartyManager::StartProcessingStateChanges() na conclusão.

A funcionalidade de síntese de texto em fala usa internamente as estimativas disponíveis de região e de medição de latência para otimizar o uso do serviço. Se a opção PartyOption::RegionUpdateConfiguration tiver sido usada para configurar um modo de atualização PartyRegionUpdateMode::Deferred, a recuperação do conjunto de regiões disponíveis e a medição da qualidade da conexão com elas podem ainda não ter começado, ou a última atualização pode ter excedido a idade do intervalo de atualização configurado. Se o dispositivo local não estiver se conectando ou conectado a nenhuma rede no momento, SetTextToSpeechProfile() garante que qualquer atualização de região adiada tenha começado e que o PartyRegionsChangedStateChange associado seja fornecido antes da conclusão do PartySetTextToSpeechProfileCompletedStateChange desta chamada.

Requisitos

Cabeçalho: Party.h

Confira também

PartyLocalChatControl
PartyLocalChatControl::GetTextToSpeechProfile
Última modificação em 20 de outubro de 2026