Lokalisatie van gebruikersinterface-elementen localization-of-user-interface-elements
Bepaalde inhoud die door de viewer wordt weergegeven, is afhankelijk van lokalisatie. Dergelijke inhoud bevat knopinfo voor gebruikersinterface-elementen en een foutbericht die wordt weergegeven wanneer de video niet kan worden afgespeeld.
Elke tekstinhoud in de viewer die kan worden gelokaliseerd, wordt vertegenwoordigd door een speciale Viewer SDK-id met de naam SYMBOL. Elk SYMBOL heeft een aan de standaardwaarde gekoppelde tekstwaarde voor de landinstelling Engels ( "en" ) die wordt geleverd bij de viewer buiten de box. Er kunnen ook door de gebruiker gedefinieerde waarden worden ingesteld voor het aantal landinstellingen dat nodig is.
Wanneer de viewer wordt gestart, wordt de huidige landinstelling gecontroleerd om te zien of er een door de gebruiker gedefinieerde waarde is voor elk ondersteund SYMBOL voor de landinstelling. Als dat het geval is, gebruikt het de user-defined waarde; anders, valt het terug naar de uit-van-de-doos standaardtekst.
Door de gebruiker gedefinieerde lokalisatiegegevens kunnen als JSON-lokalisatieobject worden doorgegeven aan de viewer. Dit object bevat een lijst met ondersteunde landinstellingen, SYMBOL-tekstwaarden voor elke landinstelling en de standaardlandinstelling.
Een voorbeeld van een dergelijk lokalisatieobject is het volgende:
{
"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"
}
In het bovenstaande voorbeeld definieert het lokalisatieobject twee landinstellingen ( "en" en "fr" ) en biedt het lokalisatie voor twee gebruikersinterface-elementen in elke landinstelling.
De webpaginacode moet het lokalisatieobject doorgeven aan de viewerconstructor als een waarde van het localizedTexts -veld van het configuratieobject. Een andere optie is het doorgeven van het lokalisatieobject door de methode setLocalizedTexts(localizationInfo) aan te roepen.
De volgende SYMBOL's worden ondersteund: