用户界面元素的本地化

交互式视频查看器显示的某些内容需要本地化。 此类内容包括用户界面元素工具提示和在视频无法播放时显示的错误消息。

查看器中每个可以本地化的文本内容都由名为SYMBOL的特殊查看器SDK标识符表示。 任何SYMBOL都具有随现成查看器提供的英语区域设置("en")的默认关联文本值。 它还可以根据需要为所需数量的区域设置用户定义的值。

查看器启动时，它会检查当前区域设置，以查看此区域设置的每个支持的SYMBOL是否有用户定义的值。 如果存在，则使用用户定义的值；否则，它会回退到现成的默认文本。

用户定义的本地化数据可以作为本地化JSON对象传递到查看器。 此类对象包含支持的区域设置列表、每个区域设置的SYMBOL文本值以及默认区域设置。

此类本地化对象的示例如下：

{
"en":{
"VideoPlayer.ERROR":"Your Browser does not support HTML5 Video tag or the video cannot be played.",
"PlayPauseButton.TOOLTIP_SELECTED":"Play"
 },
 "fr":{
"VideoPlayer.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)方法来传递本地化对象。

支持以下符号：

符号

工具提示……

容器.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_UNSELECTED

全屏状态的全屏按钮。

ClosedCaptionButton.TOOLTIP_SELECTED

选定的隐藏式字幕按钮状态。

ClosedCaptionButton.TOOLTIP_UNSELECTED

取消选择的隐藏式字幕按钮状态。

InteractiveSwatches.BANNER

横幅的标题。

ScrollUpButton.TOOLTIP

向上滚动按钮。

ScrollDownButton.TOOLTIP

向下滚动按钮。

SocialShare.TOOLTIP

社交共享工具。

LinkShare.TOOLTIP

链接共享按钮。

LinkShare.HEADER

链接对话框标题。

LinkShare.TOOLTIP_HEADER_CLOSE

“链接”对话框右上关闭按钮。

LINKShare.DESCRIPTION

共享链接的描述。

LinkShare.CANCEL

“取消”按钮的说明。

LinkShare.TOOLTIP_CANCEL

“取消”按钮。

LinkShare.ACTION

“全选”按钮的说明。

LinkShare.TOOLTIP_ACTION

选择全部按钮。

FacebookShare.TOOLTIP

Facebook共享按钮。

TwitterShare.TOOLTIP

Twitter共享按钮。

CloseButton.TOOLTIP

“行动动员”面板“关闭”按钮。

VideoPlayer.ERROR

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

在此页面上