视频查看器显示的某些内容需要本地化。 此内容包括用户界面元素工具提示以及在视频无法播放时显示的错误消息。
查看器中每个可以本地化的文本内容都由一个名为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 |
用于取消选择的隐藏式字幕按钮状态的工具提示。 |
SocialShare.TOOLTIP |
社交共享工具的工具提示。 |
EmailShare.TOOLTIP |
电子邮件共享按钮的工具提示。 |
EmailShare.HEADER |
电子邮件对话框标题的工具提示。 |
EmailShare.TOOLTIP_HEADER_CLOSE |
电子邮件对话框右上方关闭按钮的工具提示。 |
EmailShare.INVALID_ADDRESSS |
在电子邮件地址格式不正确时显示的错误消息的工具提示。 |
EmailShare.TO |
“To”输入字段的标签。 |
EmailShare.TOOLTIP_ADD |
“添加其他电子邮件地址”按钮的工具提示。 |
EmailShare.ADD |
“添加其他电子邮件地址”按钮的标题。 |
EmailShare.FROM |
“从”输入字段的标签。 |
EmailShare.MESSAGE |
“消息”输入字段的标签。 |
EmailShare.TOOLTIP_REMOVE |
“删除电子邮件地址”按钮的工具提示。 |
EmailShare.CANCEL |
“取消”按钮的说明。 |
EmailShare.TOOLTIP_CANCEL |
“取消”按钮的工具提示。 |
EmailShare.CLOSE |
表单提交后对话框底部显示关闭按钮的说明。 |
EmailShare.TOOLTIP_CLOSE |
表单提交后对话框底部显示关闭按钮的工具提示。 |
EmailShare.ACTION |
表单提交按钮的说明。 |
EmailShare.TOOLTIP_ACTION |
表单提交按钮的工具提示。 |
EmailShare.SEND_SUCCESS |
成功发送电子邮件时显示确认消息。 |
EmailShare.SEND_FAILURE |
电子邮件未成功发送时显示的错误消息。 |
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共享按钮的工具提示。 |
VideoPlayer.ERROR |
无法播放视频时显示的错误消息的工具提示。 |