Certains contenus affichés par la visionneuse de médias mixtes peuvent être localisés. Cette ligne directrice comprend les boutons de zoom, les boutons à 360°, les commandes vidéo, le bouton de fermeture, le bouton plein écran et les boutons de défilement des échantillons.
Chaque contenu textuel de la visionneuse qui peut être localisé est représenté par un identifiant spécial du SDK de la visionneuse appelé SYMBOL. Tout SYMBOL est associé par défaut à une valeur de texte par le paramètre régional anglais ( "en"
) fourni avec la visionneuse prête à l’emploi. Il peut également y avoir des valeurs définies par l’utilisateur définies pour autant de paramètres régionaux que nécessaire.
Lorsque la visionneuse démarre, elle vérifie les paramètres régionaux actuels afin de déterminer s’il existe une valeur définie par l’utilisateur pour chaque SYMBOL pris en charge pour le paramètre régional. Si tel est le cas, elle utilise la valeur définie par l’utilisateur ; dans le cas contraire, il revient au texte par défaut d’usine.
Les données de localisation définies par l’utilisateur peuvent être transmises à la visionneuse en tant qu’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":{
"CloseButton.TOOLTIP":"Close",
"ZoomInButton.TOOLTIP":"Zoom In"
},
"fr":{
"CloseButton.TOOLTIP":"Fermer",
"ZoomInButton.TOOLTIP":"Agrandir"
},
defaultLocale:"en"
}
Dans l’exemple ci-dessus, l’objet de localisation définit deux paramètres régionaux ( "en"
et "fr"
) et permet de localiser deux éléments de l’interface utilisateur dans chaque langue.
Le code de page web doit transmettre l’objet de localisation au constructeur de visionneuse en tant que valeur de la variable localizedTexts
de l’objet de configuration. Une autre option consiste à transmettre l’objet de localisation en appelant la fonction setLocalizedTexts(localizationInfo)
.
Les SYMBOLES suivants sont pris en charge :
SYMBOLE |
Info-bulle pour... |
---|---|
Container.LABEL |
Libellé ARIA pour l’élément de visionneuse de niveau supérieur. |
ZoomView.ROLE_DESCRIPTION |
Description du rôle ARIA pour le composant d’affichage principal. |
ZoomView.USAGE_HINT |
Conseils d’utilisation ARIA pour les utilisateurs de clavier. |
SpinView.ROLE_DESCRIPTION |
Description du rôle ARIA pour le composant d’affichage principal. |
SpinView.USAGE_HINT |
Conseils d’utilisation ARIA pour les utilisateurs de clavier. |
FlyoutZoomView.ROLE_DESCRIPTION |
Description du rôle ARIA pour le composant d’affichage principal. |
FlyoutZoomView.USAGE_HINT |
Conseils d’utilisation ARIA pour les utilisateurs de clavier. |
CloseButton.TOOLTIP |
Bouton Fermer . |
ZoomInButton.TOOLTIP |
Bouton Zoom avant. |
ZoomOutButton.TOOLTIP |
Bouton Zoom arrière. |
ZoomResetButton.TOOLTIP |
Bouton Réinitialiser le zoom . |
FlyoutZoomView.TIP_BUBBLE_OVER |
Systèmes de bureau dans inline mode zoom. |
FlyoutZoomView.TIP_BUBBLE_TAP |
Appareils tactiles dans inline mode zoom. |
FullScreenButton.TOOLTIP_SELECTED |
Bouton Plein écran en état normal. |
FullScreenButton.TOOLTIP_UNSELECTED |
Bouton Plein écran en mode Plein écran. |
ClosedCaptionButton.TOOLTIP_SELECTED |
Etat du bouton de fermeture de la légende sélectionné. |
ClosedCaptionButton.TOOLTIP_UNSELECTED |
État du bouton de sous-titrage codé non sélectionné. |
ScrollLeftButton.TOOLTIP |
Bouton de défilement à gauche. |
ScrollRightButton.TOOLTIP |
Bouton de défilement à droite. |
ScrollUpButton.TOOLTIP |
Bouton de défilement vers le haut. |
ScrollDownButton.TOOLTIP |
Bouton de défilement vers le bas. |
PanLeftButton.TOOLTIP |
Bouton à 360° à gauche. |
PanRightButton.TOOLTIP |
Bouton à droite de la rotation. |
PlayPauseButton.TOOLTIP_SELECTED |
État du bouton de mise en pause de la lecture sélectionné. |
PlayPauseButton.TOOLTIP_UNSELECTED |
Désélectionnez l’état du bouton de pause de lecture. |
PlayPauseButton.TOOLTIP_REPLAY |
État du bouton Lire la pause. |
VideoScrubber.TOOLTIP |
Défilement vidéo. |
VideoTime.TOOLTIP |
Temps de la vidéo sur la barre de contrôle. |
MutableVolume.TOOLTIP_SELECTED |
État du volume modifiable sélectionné. |
MutableVolume.TOOLTIP_UNSELECTED |
Volume modifiable désélectionné. |
MutableVolume.TOOLTIP_VOLUME |
Étiquette de bouton de réglette de volume exposée par ARIA aria-valuetext attribut. |
VideoPlayer.ERROR |
Message d’erreur qui s’affiche lorsqu’aucune lecture vidéo n’est possible. |