Localizzazione degli elementi dell’interfaccia utente localization-of-user-interface-elements
Alcuni contenuti visualizzati dal visualizzatore di file multimediali diversi sono soggetti a localizzazione. Questa linea guida include pulsanti di zoom, pulsanti di rotazione, controlli video, pulsante di chiusura, pulsante a schermo intero e pulsanti di scorrimento dei campioni.
Ogni contenuto testuale nel visualizzatore che può essere localizzato è rappresentato da uno speciale identificatore SDK del visualizzatore chiamato SYMBOL. Qualsiasi simbolo ha un valore di testo associato predefinito per le impostazioni locali inglesi ( "en"
) fornito con il visualizzatore predefinito. Può inoltre disporre di valori definiti dall'utente impostati per il numero di impostazioni internazionali necessario.
All'avvio, il visualizzatore controlla le impostazioni locali correnti per verificare se è presente un valore definito dall'utente per ciascun SIMBOLO supportato per le impostazioni locali. In caso affermativo, viene utilizzato il valore definito dall’utente; in caso contrario, viene utilizzato il testo predefinito.
I dati di localizzazione definiti dall’utente possono essere trasmessi al visualizzatore come oggetto JSON di localizzazione. Tale oggetto contiene l'elenco delle impostazioni locali supportate, i valori di testo SYMBOL per ciascuna impostazione locale e le impostazioni locali predefinite.
Un esempio di tale oggetto di localizzazione è il seguente:
{
"en":{
"CloseButton.TOOLTIP":"Close",
"ZoomInButton.TOOLTIP":"Zoom In"
},
"fr":{
"CloseButton.TOOLTIP":"Fermer",
"ZoomInButton.TOOLTIP":"Agrandir"
},
defaultLocale:"en"
}
Nell'esempio precedente, l'oggetto di localizzazione definisce due impostazioni locali ( "en"
e "fr"
) e fornisce la localizzazione per due elementi dell'interfaccia utente in ciascuna impostazione locale.
Il codice della pagina Web deve passare l'oggetto di localizzazione al costruttore del visualizzatore come valore del campo localizedTexts
dell'oggetto di configurazione. In alternativa, passare l'oggetto di localizzazione chiamando il metodo setLocalizedTexts(localizationInfo)
.
Sono supportati i seguenti SIMBOLI: