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.

Screenshot che mostra l'esperienza di integrazione dei sottotitoli nascosti nella libreria dell'interfaccia utente.

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

Configurare la funzionalità

Abilitare i sottotitoli nascosti

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

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

val localOptions = 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