使用者介面元素的本地化 localization-of-user-interface-elements

Video Viewer所顯示的某些內容必須經過本地化。 此內容包含使用者介面元素工具提示,以及在無法播放視訊時顯示的錯誤訊息。

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

符號
說明
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
「新增其他電子郵件地址」按鈕的標題。
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
無法播放視訊時所顯示錯誤訊息的工具提示。
recommendation-more-help
b7426f53-aad9-4c00-83fc-664f30f681e8