Legendas ocultas

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

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

Legendas baseadas nos Serviços de Comunicação do Azure

Suporte para chamadas envolvendo somente usuários dos Serviços de Comunicação do Azure. Atualmente, as legendas dos Serviços de Comunicação do Azure não dão suporte à tradução de idioma.

Legendas ocultas de Interoperabilidade do Teams

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

Suporte à tradução

Ao contrário das legendas ocultas dos Serviços de Comunicação do Azure, as legendas ocultas de Interoperabilidade do Teams dão suporte à tradução. Os usuários podem optar por ter legendas ocultas traduzidas para um outro idioma por meio das configurações de legendas.

Como usar as legendas

As legendas são integradas perfeitamente ao CallingUILibrary.

1. Ativar legendas:

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

2. Ajustar o idioma falado:

   • Se um idioma diferente estiver sendo usado na reunião, os usuários poderão alterar o idioma falado por meio da interface do usuário. Essa alteração se aplica a todos os usuários 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 evento. Legendas traduzidas ao vivo permitem que os usuários vejam legendas traduzidas para o idioma com o qual estão mais confortáveis.
   • Altere o idioma da legenda clicando no botão Idioma das legendas após o início das legendas, caso a tradução para um idioma diferente seja desejada.

Observação

Legendas traduzidas ao vivo em reuniões só estão disponíveis como parte do Teams Premium, uma licença de complemento 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 seu administrador de TI. Encontre mais detalhes aqui.

Idiomas com suporte

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

Idioma	Código falado do ACS	Código falado do Teams	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	de
Português do Brasil	en-au, en-ca, en-gb, en-in, en-nz, en-us	en-au, en-ca, en-gb, en-in, en-nz, en-us	en
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
Híndi	hi-in	hi-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
Holandês	nl-be, nl-nl	nl-be, nl-nl	nl
Polonês	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
Tcheco	—	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	—	uk-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 assinatura ativa. Crie uma conta gratuitamente.
• Um recurso dos Serviços de Comunicação implantado. Crie um recurso dos Serviços de Comunicação.
• Um token de acesso do usuário para habilitar o cliente de chamada. Obter um token de acesso do usuário.
• Opcional: Conclusão do início rápido para introdução aos compostos da UI Library.

Configurar o recurso

Habilitar 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);

Habilitar 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óximas etapas

• Saiba mais sobre a Biblioteca UI