「互動式視訊檢視器」所顯示的某些內容可能會受本地化規範。 這些內容包括用戶介面元素工具提示和當視頻無法播放時顯示的錯誤消息。
檢視器中可本地化的每個文字內容,都會以稱為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)
方法以傳遞本地化物件。
支援下列SYMBOL:
符號 |
工具提示…… |
---|---|
容器.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 |
取消選擇隱藏式字幕按鈕狀態。 |
InteractiveStackes.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 |
無法播放視訊時顯示的錯誤訊息。 |