Localização dos elementos da interface do usuário localization-of-user-interface-elements
Determinado conteúdo exibido pelo visualizador está sujeito a localização. Esse conteúdo inclui dicas de ferramentas do elemento da interface do usuário e uma mensagem de erro exibida quando o vídeo não pode ser reproduzido.
Todo conteúdo textual no visualizador que pode ser localizado é representado por um identificador especial do SDK do visualizador chamado SYMBOL. Qualquer SYMBOL tem um valor de texto associado ao padrão para a localidade em inglês ( "en"
) fornecido com o visualizador pronto para uso. Ela também pode ter valores definidos pelo usuário definidos para quantas localidades forem necessárias.
Quando o visualizador é iniciado, ele verifica o local atual para ver se há um valor definido pelo usuário para cada SYMBOL suportado para o local. Se houver, ele usará o valor definido pelo usuário; caso contrário, ele voltará para o texto padrão pronto para uso.
Os dados de localização definidos pelo usuário podem ser passados para o visualizador como um objeto JSON de localização. Esse objeto contém a lista de localidades suportadas, valores de texto SYMBOL para cada localidade e a localidade padrão.
Um exemplo desse objeto de localização é o seguinte:
{
"en":{
"Video360Player.ERROR":"Your Browser does not support HTML5 Video tag or the video cannot be played.",
"PlayPauseButton.TOOLTIP_SELECTED":"Play"
},
"fr":{
"Video360Player.ERROR":"Votre navigateur ne prend pas en charge la vidéo HTML5 tag ou la vidéo ne peuvent pas être lus.",
"PlayPauseButton.TOOLTIP_SELECTED":"Jouer"
},
defaultLocale:"en"
}
No exemplo acima, o objeto de localização define duas localidades ( "en"
e "fr"
) e fornece localização para dois elementos de interface do usuário em cada localidade.
O código da página da Web deve passar o objeto de localização para o construtor do visualizador como um valor do campo localizedTexts
do objeto de configuração. Uma opção alternativa é passar o objeto de localização chamando o método setLocalizedTexts(localizationInfo)
.
Os seguintes SYMBOLs são suportados: