用户界面元素的本地化 localization-of-user-interface-elements

智能裁剪视频查看器显示的某些内容需要进行本地化。 此内容包括用户界面元素工具提示和一条错误消息,当视频无法播放时将会显示。

查看器中的每个可本地化的文本内容都由一个名为SYMBOL的特殊查看器SDK标识符表示。 任何SYMBOL都具有英语语言环境( "en")。 它还可以根据需要为任意数量的区域设置用户定义的值。

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

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

以下是此类本地化对象的示例:

{
"en":{
"SmartCropVideoPlayer.ERROR":"Your Browser does not support HTML5 Video tag or the video cannot be played.",
"PlayPauseButton.TOOLTIP_SELECTED":"Play"
 },
 "fr":{
"SmartCropVideoPlayer.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_UNSELECTED
取消选择全屏按钮状态的工具提示。
ClosedCaptionButton.TOOLTIP_SELECTED
所选隐藏式字幕按钮状态的工具提示。
ClosedCaptionButton.TOOLTIP_UNSELECTED
取消选择隐藏式字幕按钮状态的工具提示。
SocialShare.TOOLTIP
社交共享工具的工具提示。
EmailShare.TOOLTIP
电子邮件共享按钮的工具提示。
EmailShare.HEADER
电子邮件对话框标题的工具提示。
EmailShare.TOOLTIP_HEADER_CLOSE
电子邮件对话框右上角关闭按钮的工具提示。
EmailShare.INVALID_ADDRESS
如果电子邮件地址格式不正确,则显示错误消息的工具提示。
EmailShare.TO
“至”输入字段的标签。
EmailShare.TOOLTIP_ADD
“添加其他电子邮件地址”按钮的工具提示。
EmailShare.ADD
“Add Another Email Address”按钮的标题。
EmailShare.FROM
“从”输入字段的标签。
EmailShare.MESSAGE
“消息”输入字段的标签。
EmailShare.TOOL提示删除
“删除电子邮件地址”按钮的工具提示。
EmailShare.CANCEL
“取消”按钮的标题。
EmailShare.TOOL提示取消
“取消”按钮的工具提示。
EmailShare.CLOSE
表单提交后对话框底部显示的关闭按钮的题注。
EmailShare.TOOL提示关闭
表单提交后对话框底部显示的关闭按钮的工具提示。
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.TOOL提示取消
“取消”按钮的工具提示。
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共享按钮的工具提示。
SmartCropVideoPlayer.ERROR
无法播放视频时出现错误消息的工具提示。
recommendation-more-help
b7426f53-aad9-4c00-83fc-664f30f681e8