Legendas ocultas

As legendas ocultas desempenham um papel fundamental em aplicativos de chamadas de voz de vídeo, fornecendo inúmeros benefícios que melhoram a acessibilidade, usabilidade e experiência geral do usuário dessas plataformas.

Neste artigo, você aprenderá a habilitar cenários de legendas ocultas usando a Biblioteca da Interface do Usuário. Há dois cenários principais para habilitar legendas ocultas: chamadas de vídeo e voz dos Serviços de Comunicação do Azure e chamadas de interoperabilidade.

Legendas baseadas no Serviço de Comunicação do Azure

Com suporte para chamadas envolvendo somente usuários do Serviço de Comunicação do Azure. Atualmente, as legendas do Serviço de Comunicação do Azure não oferecem suporte à tradução de idiomas.

Legendas ocultas do Teams Interop

Suporte durante chamadas com um ou mais usuários do Teams.

Apoio à tradução

Ao contrário das legendas ocultas do Serviço de Comunicação do Azure, as legendas ocultas do Teams Interop oferecem suporte à tradução. Os utilizadores podem optar por ter as legendas ocultas traduzidas para um idioma diferente através das definições de legendas.

Como usar legendas

As legendas são perfeitamente integradas no CallingUILibrary.

1. Ativar legendas:

   • Durante uma chamada conectada, navegue até a barra de controle e clique no botão mais.
   • No menu pop-up, alterne para ativar as legendas.

2. Ajuste o idioma falado:

   • Se estiver a ser utilizado um idioma diferente na reunião, os utilizadores podem alterar o idioma falado através da IU. Esta alteração aplica-se a todos os utilizadores na chamada.

3. Definir idioma da legenda (para legendas ocultas de interoperabilidade do Teams):

   • Por padrão, as legendas ao vivo são exibidas no idioma falado da reunião ou do evento. As legendas traduzidas ao vivo permitem que os usuários vejam as legendas traduzidas para o idioma com o qual se sentem mais confortáveis.
   • Altere o idioma da legenda clicando no botão Idioma das legendas após o início das legendas, se a tradução para um idioma diferente for desejada.

Nota

As legendas traduzidas ao vivo em reuniões só estão disponíveis como parte do Teams Premium, uma licença complementar que fornece recursos adicionais para tornar as reuniões do Teams mais personalizadas, inteligentes e seguras. Para obter acesso ao Teams Premium, entre em contato com o administrador de TI. Mais detalhes você pode encontrá-lo aqui.

Idiomas suportados

Os Serviços de Comunicação do Azure dão suporte a vários idiomas falados para legendas. A próxima tabela contém a lista de códigos de idioma suportados que você pode usar com o setSpokenLanguage método para definir o idioma desejado para legendas.

Idioma	Código falado ACS	Código falado das equipas	Código de legendas do Teams
Árabe	ar-ae, ar-sa	ar-ae, ar-sa	ar
Dinamarquês	DA-DK	DA-DK	da
Alemão	de-de	de-de	al
Inglês	en-au, en-ca, en-gb, en-in, en-nz, en-us	en-au, en-ca, en-gb, en-in, en-nz, en-us	in
Espanhol	es-es, es-mx	es-es, es-mx	es
Finlandês	FI-FI	FI-FI	fi
Francês	fr-ca, fr-fr	fr-ca, fr-fr	fr, fr-ca
Hindi	oi-in	oi-in	hi
Italiano	it-it	it-it	it
Japonês	ja-jp	ja-jp	ja
Coreano	Ko-KR	Ko-KR	ko
Norueguês	nb-no	nb-no	nb
Neerlandês	nl-be, nl-nl	nl-be, nl-nl	nl
Polaco	PL-PL	PL-PL	pl
Português	pt-br	PT-BR, PT-PT	PT, PT-PT
Russo	Ru-RU	Ru-RU	ru
Sueco	SV-SE	SV-SE	sv
Chinês	zh-cn, zh-hk	zh-cn, zh-hk	zh-Hans, zh-Hant
Checo	—	CS-CZ	cs
Eslovaco	—	SK-SK	sk
Turco	—	tr-tr	tr
Vietnamita	—	VI-VN	vi
Tailandês	—	th-th	th
Hebraico	—	he-il	he
Galês	—	CY-GB	cy
Ucraniano	—	Reino Unido-UA	uk
Grego	—	el-gr	el
Húngaro	—	hu-hu	hu
Romeno	—	ro-ro	ro

Verifique se o idioma falado selecionado corresponde ao idioma usado na chamada para gerar legendas com precisão.

Pré-requisitos

• Uma conta do Azure com uma subscrição ativa. Crie uma conta gratuitamente.
• Um recurso de Serviços de Comunicação implantado. Crie um recurso de Serviços de Comunicação.
• Um token de acesso de usuário para habilitar o cliente de chamada. Obtenha um token de acesso de usuário.
• Opcional: conclusão do início rápido para começar a usar os compostos da Biblioteca da Interface do Usuário.

Configurar o recurso

Ativar legendas ocultas

O método setCaptionsOn é configurado para iniciar legendas por padrão.

Kotlin

val captionsOptions = CallCompositeCaptionsOptions()
captionsOptions.setCaptionsOn(true)
captionsOptions.setSpokenLanguage("en-US")

val localOptions = CallCompositeLocalOptions()
localOptions.setCaptionsOptions(captionsOptions)

Java

CallCompositeCaptionsOptions captionsOptions = new CallCompositeCaptionsOptions();
captionsOptions.setCaptionsOn(true);
captionsOptions.setSpokenLanguage("en-us");

CallCompositeLocalOptions localOptions = new CallCompositeLocalOptions();
localOptions.setCaptionsOptions(captionsOptions);

Ativar legendas ocultas

O método captionsOn é configurado para iniciar legendas por padrão.

let captionsOptions = CaptionsOptions(
    captionsOn: true, 
    spokenLanguage: "en-US"
)

let localOptions = LocalOptions(
    participantViewData: participantViewData,
    setupScreenViewData: setupScreenViewData,
    cameraOn: false,
    microphoneOn: false,
    skipSetupScreen: false,
    audioVideoMode: .audioAndVideo,
    captionsOptions: captionsOptions
)

Próximos passos

• Saiba mais sobre a biblioteca da interface do usuário