Sintaxe
Parâmetros
options PartyVoiceChatTranscriptionOptions
Opções associadas à transcrição do chat de voz, como quais controles de chat devem gerar transcrições para o controle de chat local e se essas transcrições devem ser traduzidas para o idioma do controle de chat local.
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
PartyErrorc_partyErrorSuccess se a operação assíncrona para definir as opções de transcrição 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
A transcrição é o processo de gerar cadeias de caracteres que representam frases faladas no chat de voz. As opções especificadas por meio deoptions especificam os controles de chat que devem gerar essas cadeias de transcrição, que são fornecidas posteriormente ao controle de chat local por meio de PartyVoiceChatTranscriptionReceivedStateChange. Somente os controles de chat configurados para usar um idioma que dê suporte à transcrição, por meio de PartyLocalDevice::CreateChatControl(), fornecerão transcrições.
A funcionalidade de transcrição de fala em texto 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, e o aplicativo especificar sinalizadores de opção que incluam PartyVoiceChatTranscriptionOptions::TranscribeSelfRegardlessOfNetworkState, SetTranscriptionOptions() garante que qualquer atualização de região adiada tenha começado e que o PartyRegionsChangedStateChange associado seja fornecido antes da conclusão do PartySetTranscriptionOptionsCompletedStateChange desta chamada.