使用者介面元素的本地化

上次更新: 2023-11-04
  • 建立對象:
  • Developer
    User

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

無法播放視訊時所顯示錯誤訊息的工具提示。

此頁面上的