用戶介面元素的本地化

混合媒體檢視器顯示的某些內容可能會受本地化規範。 這包括縮放按鈕、旋轉按鈕、視訊控制項、關閉按鈕全螢幕按鈕和色票捲動按鈕。

檢視器中可本地化的每個文字內容,都會以稱為SYMBOL的特殊檢視器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:

符號

工具提示……

容器。LABEL

頂層檢視器元素的ARIA標籤。

ZoomView.ROLE_DESCRIPTION

主視圖元件的ARIA角色說明。

ZoomView.USAGE_HINT

ARIA使用提示給鍵盤使用者。

回轉視圖。角色說明

主視圖元件的ARIA角色說明。

回轉視圖。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_UNSELECTED

全螢幕按鈕,全螢幕狀態。

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

當無法播放視訊時出現錯誤訊息。

本頁內容