查看器显示的某些内容必须进行本地化。 此类内容包括用户界面元素工具提示和当视频无法播放时显示的错误消息。
查看器中所有可以本地化的文本内容都由一个名为SYMBOL的特殊Viewer SDK标识符表示。 任何SYMBOL都有英语区域设置( "en"
)。 此外,还可以根据需要为任意数量的区域设置用户定义的值。
当查看器启动时,它会检查当前区域设置,查看区域设置的每个受支持的SYMBOL是否存在用户定义的值。 如果存在,则使用用户定义的值;否则,它会返回到现成的默认文本。
用户定义的本地化数据可以作为本地化JSON对象传递给查看器。 此类对象包含支持的区域设置列表、每个区域设置的SYMBOL文本值和默认区域设置。
以下是此类本地化对象的示例:
{
"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"
}
在上例中,本地化对象定义了两个区域设置( "en"
和 "fr"
)并为每个区域设置中的两个用户界面元素提供本地化。
网页代码应将本地化对象作为 localizedTexts
配置对象的字段。 替代选项是通过调用 setLocalizedTexts(localizationInfo)
方法。
支持以下SYMBOL:
符号 |
工具提示…… |
---|---|
Container.LABEL |
顶级查看器元素的ARIA标签。 |
PlayPauseButton.TOOLTIP_SELECTED |
选定的播放暂停按钮状态。 |
PlayPauseButton.TOOLTIP_UNSELECTED |
取消选择播放暂停按钮状态。 |
PlayPauseButton.TOOLTIP_REPLAY |
播放暂停按钮状态。 |
VideoScrubber.TOOLTIP |
视频清理器。 |
VideoTime.TOOLTIP |
控制栏上的视频时间。 |
MutableVolume.TOOLTIP_SELECTED |
选定的可变卷状态。 |
MutableVolume.TOOLTIP_UNSELECTED |
已取消选择可变卷。 |
MutableVolume.TOOLTIP_VOLUME |
通过ARIA公开的音量滑块旋钮标签 aria-valuetext 属性。 |
FullScreenButton.TOOLTIP_SELECTED |
全屏按钮处于正常状态。 |
FullScreenButton.TOOLTIP_UNSELECT |
全屏按钮处于全屏状态。 |
SocialShare.TOOLTIP |
社交共享工具。 |
EmbedShare.TOOLTIP |
嵌入共享按钮。 |
EmbedShare.HEADER |
嵌入对话框标题。 |
EmbedShare.TOOLTIP_HEADER_CLOSE |
“嵌入”对话框右上角的关闭按钮。 |
EmbedShare.DESCRIPTION |
嵌入代码文本。 |
EmbedShare.EMBED_SIZE |
嵌入大小组合框。 |
EmbedShare.CANCEL |
“取消”按钮。 |
EmbedShare.TOOLTIP_CANCEL |
“取消”按钮。 |
EmbedShare.ACTION |
“全选”按钮。 |
EmbedShare.TOOLTIP操作 |
“全选”按钮。 |
EmbedShare.CUSTOM_SIZE |
嵌入大小组合框中的最后一个“自定义大小”条目。 |
LinkShare.TOOLTIP |
链接共享按钮。 |
LinkShare.HEADER |
链接对话框标题。 |
LinkShare.TOOLTIP_HEADER_CLOSE |
链接对话框右上角的关闭按钮。 |
LinkShare.DESCRIPTION |
共享链接。 |
LinkShare.CANCEL |
“取消”按钮。 |
LinkShare.TOOLTIP_CANCEL |
“取消”按钮。 |
LinkShare.ACTION |
“全选”按钮。 |
LinkShare.TOOLTIP操作 |
“全选”按钮。 |
FacebookShare.TOOLTIP |
“Facebook共享”按钮。 |
TwitterShare.TOOLTIP |
“Twitter共享”按钮。 |
Video360Player.ERROR |
无法播放视频时显示的错误消息。 |