Localisation des éléments de l’interface utilisateur

Certains contenus affichés par le lecteur sont sujets à localisation. Cela inclut des info-bulles sur les éléments de l’interface utilisateur et un message d’erreur s’affiche lorsque la vidéo ne peut pas être lue.

Chaque contenu textuel de la visionneuse qui peut être localisé est représenté par un identifiant SDK de visionneuse spécial appelé SYMBOL. Tout SYMBOL est associé par défaut à une valeur de texte pour la langue anglaise ( "en") fournie avec le lecteur prêt à l’emploi. Il est également possible que des valeurs définies par l’utilisateur soient définies pour autant de paramètres régionaux que nécessaire.

Lorsque le lecteur de contenu début, il vérifie les paramètres régionaux actuels pour déterminer s’il existe une valeur définie par l’utilisateur pour chaque SYMBOL pris en charge pour les paramètres régionaux. Si tel est le cas, elle utilise la valeur définie par l’utilisateur ; sinon, il revient au texte par défaut prêt à l’emploi.

Les données de localisation définies par l’utilisateur peuvent être transmises au lecteur sous la forme d’un objet JSON de localisation. Cet objet contient la liste des paramètres régionaux pris en charge, les valeurs de texte SYMBOL pour chaque paramètre régional et les paramètres régionaux par défaut.

Voici un exemple d’objet de localisation :

{ 
"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" 
}

Dans l’exemple ci-dessus, l’objet localisation définit deux paramètres régionaux ( "en" et "fr") et fournit la localisation de deux éléments d’interface utilisateur dans chaque paramètre régional.

Le code de la page Web doit transmettre l’objet localisation au constructeur de la visionneuse sous la forme d’une valeur du champ localizedTexts de l’objet de configuration. Une autre option consiste à transmettre l'objet de localisation en appelant la méthode setLocalizedTexts(localizationInfo).

Les SYMBOLES suivants sont pris en charge :

SYMBOLE

Info-bulle pour...

Conteneur.LABEL

Libellé ARIA pour l’élément de lecteur de niveau supérieur.

PlayPauseButton.TOOLTIP_SELECTED

Etat du bouton Lecture pause sélectionné.

PlayPauseButton.TOOLTIP_UNSELECTED

Désélectionnez l’état du bouton Lecture pause.

PlayPauseButton.TOOLTIP_REPLAY

Etat du bouton Lecture pause.

VideoScrubber.TOOLTIP

Défilement vidéo.

VideoTime.TOOLTIP

Durée de la vidéo sur la barre de contrôle.

MutableVolume.TOOLTIP_SELECTED

Etat du volume mutable sélectionné.

MutableVolume.TOOLTIP_UNSELECTED

Volume mutable désélectionné.

MutableVolume.TOOLTIP_VOLUME

Étiquette de bouton de réglette de volume exposée au moyen de l'attribut ARIA aria-valuetext .

FullScreenButton.TOOLTIP_SELECTED

Bouton plein écran en état normal.

FullScreenButton.TOOLTIP_UNSELECTED

Bouton plein écran en mode plein écran.

SocialShare.TOOLTIP

Outil de partage sur les réseaux sociaux.

EmbedShare.TOOLTIP

Bouton d’intégration de partage.

EmbedShare.HEADER

En-tête de la boîte de dialogue d’intégration.

EmbedShare.TOOLTIP_HEADER_CLOSE

Bouton de fermeture supérieur droit de la boîte de dialogue d’intégration.

EmbedShare.DESCRIPTION

Texte du code incorporé.

EmbedShare.EMBED_SIZE

Zone de liste déroulante Taille d’intégration.

EmbedShare.CANCEL

Le bouton "Annuler".

EmbedShare.TOOLTIP_CANCEL

Le bouton "Annuler".

EmbedShare.ACTION

Le bouton "Sélectionner tout".

ACTION EmbedShare.TOOLTIP

Le bouton "Sélectionner tout".

EmbedShare.CUSTOM_SIZE

Dernière entrée "taille personnalisée" dans la zone de liste déroulante Taille d’intégration.

LinkShare.TOOLTIP

Bouton de partage de lien.

LinkShare.HEADER

En-tête de la boîte de dialogue de lien.

LinkShare.TOOLTIP_HEADER_CLOSE

Bouton de fermeture supérieur droit de la boîte de dialogue de lien.

LinkShare.DESCRIPTION

Lien de partage.

LinkShare.CANCEL

Le bouton "Annuler".

LinkShare.TOOLTIP_CANCEL

Le bouton "Annuler".

LinkShare.ACTION

Le bouton "Sélectionner tout".

ACTION LinkShare.TOOLTIP

Le bouton "Sélectionner tout".

FacebookShare.TOOLTIP

Bouton de partage Facebook.

TwitterShare.TOOLTIP

Bouton de partage Twitter.

Video360Player.ERROR

Message d’erreur qui s’affiche lorsqu’aucune lecture vidéo n’est possible.

Sur cette page