用户界面元素的本地化

混合媒体查看器显示的某些内容必须进行本地化。 此准则包括缩放按钮、旋转按钮、视频控件、关闭按钮、全屏按钮和样本滚动按钮。

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

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

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

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

{
"en":{
"CloseButton.TOOLTIP":"Close",
"ZoomInButton.TOOLTIP":"Zoom In"
 },
 "fr":{
"CloseButton.TOOLTIP":"Fermer",
"ZoomInButton.TOOLTIP":"Agrandir"
},
defaultLocale:"en"
}

在上例中，本地化对象定义了两个区域设置( "en" 和 "fr")并为每个区域设置中的两个用户界面元素提供本地化。

网页代码应将本地化对象作为 localizedTexts 配置对象的字段。 替代选项是通过调用 setLocalizedTexts(localizationInfo) 方法。

支持以下SYMBOL：

符号

工具提示……

Container.LABEL

顶级查看器元素的ARIA标签。

ZoomView.ROLE_DESCRIPTION

主视图组件的ARIA角色描述。

ZoomView.USAGE_HINT

键盘用户的ARIA使用提示。

SpinView.ROLE_DESCRIPTION

主视图组件的ARIA角色描述。

SpinView.USAGE_HINT

键盘用户的ARIA使用提示。

FlyoutZoomView.ROLE_DESCRIPTION

主视图组件的ARIA角色描述。

FlyoutZoomView.USAGE_HINT

键盘用户的ARIA使用提示。

CloseButton.TOOLTIP

关闭按钮。

ZoomInButton.TOOLTIP

放大按钮。

ZoomOutButton.TOOLTIP

缩小按钮。

ZoomResetButton.TOOLTIP

缩放重置按钮。

FlyoutZoomView.TIP_BUBBLE_OVER

中的台式机系统 内联 缩放模式。

FlyoutZoomView.TIP_BUBBLE_TAP

中的触控设备 内联 缩放模式。

FullScreenButton.TOOLTIP_SELECTED

全屏按钮处于正常状态。

FullScreenButton.TOOLTIP_UNSELECT

全屏按钮处于全屏状态。

ClosedCaptionButton.TOOLTIP_SELECTED

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

ClosedCaptionButton.TOOLTIP_UNSELECTED

未选择隐藏式字幕按钮状态。

ScrollLeftButton.TOOLTIP

“向左滚动”按钮。

ScrollRightButton.TOOLTIP

向右滚动按钮。

ScrollUpButton.TOOLTIP

向上滚动按钮。

ScrollDownButton.TOOLTIP

向下滚动按钮。

PanLeftButton.TOOLTIP

向左旋转按钮。

PanRightButton.TOOLTIP

向右旋转按钮。

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 属性。

VideoPlayer.ERROR

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

在此页面上