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 |
無法播放視訊時出現的錯誤訊息的工具提示。 |