Sottotitoli

I sottotitoli chiusi svolgono un ruolo fondamentale nelle app per chiamate vocali video, offrendo numerosi vantaggi che migliorano l'accessibilità, l'usabilità e l'esperienza utente complessiva di queste piattaforme.

In questo articolo si apprenderà come abilitare scenari di sottotitoli chiusi usando la libreria dell'interfaccia utente. Esistono due scenari principali per abilitare sottotitoli chiusi: video e chiamate vocali di Servizi di comunicazione di Azure e chiamate di interoperabilità.

Sottotitoli basati su Servizi di comunicazione di Azure

Supportato solo per le chiamate che coinvolgono gli utenti del Servizio di comunicazione di Azure. Attualmente, le didascalie del servizio di comunicazione di Azure non supportano la traduzione della lingua.

Sottotitoli chiusi di Interoperabilità di Teams

Supportato durante le chiamate con uno o più utenti di Teams.

Supporto per la traduzione

A differenza dei sottotitoli chiusi del servizio di comunicazione di Azure, le didascalie chiuse di Interoperabilità di Teams supportano la traduzione. Gli utenti possono scegliere di avere sottotitoli tradotti in una lingua diversa tramite le impostazioni delle didascalie.

Come usare le didascalie

Le didascalie sono perfettamente integrate all'interno di CallingUILibrary.

1. Attivare le didascalie:

   • Durante una chiamata connessa, passare alla barra di controllo e fare clic sul pulsante altro.
   • Nel menu a comparsa attiva/disattiva per attivare le didascalie.

2. Regolare la lingua parlata:

   • Se viene usata una lingua diversa nella riunione, gli utenti possono modificare la lingua parlata tramite l'interfaccia utente. Questa modifica si applica a tutti gli utenti nella chiamata.

3. Impostare la lingua della didascalia (per le didascalie chiuse di interoperabilità di Teams):

   • Per impostazione predefinita, le didascalie in tempo reale vengono visualizzate nella lingua parlata della riunione o dell'evento. Le didascalie tradotte in tempo reale consentono agli utenti di visualizzare le didascalie tradotte nella lingua con cui sono più a proprio agio.
   • Modificare la lingua della didascalia facendo clic sul pulsante Lingua sottotitoli dopo l'avvio delle didascalie, se si desidera eseguire la traduzione in una lingua diversa.

Nota

Le didascalie tradotte in tempo reale nelle riunioni sono disponibili solo come parte di Teams Premium, una licenza di componente aggiuntivo che offre funzionalità aggiuntive per rendere le riunioni di Teams più personalizzate, intelligenti e sicure. Per ottenere l'accesso a Teams Premium, contattare l'amministratore IT. Altri dettagli sono disponibili qui.

Lingue supportate

Servizi di comunicazione di Azure supporta varie lingue parlate per le didascalie. La tabella successiva contiene l'elenco dei codici linguistici supportati che è possibile usare con il metodo setSpokenLanguage per impostare la lingua desiderata per le didascalie.

Lingua	Codice parlato ACS	Codice parlato di Teams	Codice delle didascalie di Teams
arabo	ar-ae, ar-sa	ar-ae, ar-sa	ar
Danese	da-dk	da-dk	da
Tedesco	de-de	de-de	de
italiano	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
Spagnolo	es-es, es-mx	es-es, es-mx	es
Finlandese	fi-fi	fi-fi	fi
Francese	fr-ca, fr-fr	fr-ca, fr-fr	fr, fr-ca
Hindi	hi-in	hi-in	hi
Italiano	it-it	it-it	it
Giapponese	ja-jp	ja-jp	ja
Coreano	ko-kr	ko-kr	ko
Norvegese	nb-no	nb-no	nb
Olandese	nl-be, nl-nl	nl-be, nl-nl	nl
Polacco	pl-pl	pl-pl	pl
Portoghese	pt-br	pt-br, pt-pt	pt, pt-pt
Russo	ru-ru	ru-ru	ru
Svedese	sv-se	sv-se	sv
Cinese	zh-cn, zh-hk	zh-cn, zh-hk	zh-Hans, zh-Hant
Ceco	—	cs-cz	cs
Slovacco	—	sk-sk	sk
Turco	—	tr-tr	tr
Vietnamita	—	vi-vn	vi
Thai	—	th-th	th
Ebraico	—	he-il	he
Gallese	—	cy-gb	cy
Ucraino	—	uk-ua	uk
Greco	—	el-gr	el
Ungherese	—	hu-hu	hu
Romeno	—	ro-ro	ro

Verificare che la lingua parlata selezionata corrisponda alla lingua usata nella chiamata per generare con precisione le didascalie.

Prerequisiti

• Un account Azure con una sottoscrizione attiva. Creare un account gratuitamente.
• Una risorsa di Servizi di comunicazione distribuita. Creare una risorsa di Servizi di comunicazione.
• Token di accesso utente per abilitare il client di chiamata. Ottenere un token di accesso utente.
• Facoltativo: completamento della Guida introduttiva per iniziare a usare i compositi della libreria dell'interfaccia utente.

Configurare la funzionalità

Abilitare i sottotitoli nascosti

Il metodo setCaptionsOn è configurato per avviare le didascalie per impostazione predefinita.

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

Abilitare i sottotitoli nascosti

Il metodo captionsOn è configurato per avviare le didascalie per impostazione predefinita.

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
)

Passaggi successivi

• Altre informazioni sulla libreria dell'interfaccia utente