用户界面元素的本地化

查看器显示的某些内容必须进行本地化。 此类内容包括用户界面元素工具提示和当视频无法播放时显示的错误消息。

查看器中所有可以本地化的文本内容都由一个名为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

无法播放视频时显示的错误消息。

在此页面上