Pular para o conteúdo principal
Informações específicas do tipo de alteração de estado VoiceChatTranscriptionReceived.

Sintaxe

Membros

result   PartyStateChangeResult Indica que a operação de transcrição teve êxito (Succeeded) ou fornece o motivo da falha. Em caso de êxito, o campo transcription é uma cadeia de caracteres de comprimento diferente de zero. Em caso de falha, a cadeia de caracteres fica vazia. A falha indica que uma operação de transcrição foi tentada para o locutor, mas não pôde ser concluída. Se a transcrição estiver habilitada a pedido do usuário associado ao controle de chat e as mensagens de transcrição forem mostradas na interface do usuário, é recomendável que as falhas também sejam indicadas ao usuário para informar se as transcrições estão pendentes ou falharam. errorDetail   PartyError Um valor de diagnóstico que fornece informações adicionais de solução de problemas sobre qualquer possível condição de erro. A forma legível deste detalhe de erro pode ser obtida por meio de PartyManager::GetErrorMessage(). senderChatControl   PartyChatControl* O objeto de controle de chat que originou a mensagem de transcrição. receiverChatControlCount   uint32_t O número de controles de chat receptores locais aos quais a transcrição é endereçada. receiverChatControls   PartyLocalChatControlArray
matriz de tamanho receiverChatControlCount
Os controles de chat receptores locais aos quais a transcrição é endereçada. sourceType   PartyAudioSourceType O tipo de fonte de áudio que esta transcrição representa. O tipo de fonte de áudio pode opcionalmente ser usado em cenários de jogo nos quais transcrições de tipos de fonte diferentes devem ser tratadas de maneira diferente. Por exemplo, uma iconografia diferente pode ser mostrada dependendo de a transcrição estar associada a áudio de microfone ou de conversão de texto em fala. languageCode   PartyString O código de idioma da transcrição. O código de idioma é sempre fornecido quando o campo result indica êxito. Caso contrário, o código de idioma é uma cadeia de caracteres vazia.

O código de idioma está no formato BCP 47, como en-US para inglês (Estados Unidos). Os códigos de idioma com suporte estão enumerados em Suporte a idiomas.
transcription   PartyString O texto transcrito do chat de voz. A cadeia de caracteres pode ter até c_maxChatTextMessageLength caracteres, sem incluir o terminador nulo. A cadeia de caracteres fica sempre vazia quando o campo result indica falhas. type   PartyVoiceChatTranscriptionPhraseType Indica o tipo de frase do texto fornecido no campo transcription. O tipo é sempre PartyVoiceChatTranscriptionPhraseType::Final quando o campo result indica falha. translationCount   uint32_t O número de traduções associadas ao texto transcrito do chat de voz. As traduções são fornecidas se PartyVoiceChatTranscriptionOptions::TranslateToLocalLanguage tiver sido especificado anteriormente por meio de PartyLocalChatControl::SetTranscriptionOptions() em um controle de chat local deste dispositivo. Pode haver mais de uma tradução se vários controles de chat locais tiverem habilitado a tradução e tiverem especificado idiomas diferentes por meio de PartyLocalDevice::CreateChatControl(). Nesse caso, o aplicativo pode comparar o campo languageCode de cada PartyTranslation em translations com o código de idioma, obtido por meio de PartyLocalChatControl::GetLanguage(), de cada controle de chat local em receiverChatControls para determinar o controle de chat local de destino de cada tradução. translations   PartyTranslation*
matriz de tamanho translationCount
Uma matriz que contém as traduções da cadeia de caracteres de transcrição do chat de voz. As traduções são fornecidas se PartyVoiceChatTranscriptionOptions::TranslateToLocalLanguage tiver sido especificado anteriormente por meio de PartyLocalChatControl::SetTranscriptionOptions() em um controle de chat local deste dispositivo. Pode haver mais de uma tradução se vários controles de chat locais tiverem habilitado a tradução e tiverem especificado idiomas diferentes por meio de PartyLocalDevice::CreateChatControl(). Nesse caso, o aplicativo pode comparar o campo languageCode de cada PartyTranslation em translations com o código de idioma, obtido por meio de PartyLocalChatControl::GetLanguage(), de cada controle de chat local em receiverChatControls para determinar o controle de chat local de destino de cada tradução.

É fornecida uma tradução correspondente ao idioma de cada controle de chat em receiverChatControls que tenha habilitado a tradução, mesmo que o idioma do controle de chat que está falando seja o mesmo do controle de chat local. Nesse caso, as cadeias de caracteres de transcrição e de tradução são idênticas.

Requisitos

Cabeçalho: Party.h

Confira também

Membros do Party
PartyLocalDevice::CreateChatControl
PartyLocalChatControl::SetTranscriptionOptions
Última modificação em 20 de outubro de 2026