用戶介面元素的本地化

視訊檢視器顯示的某些內容可能會受到當地語系化的限制。 此內容包括使用者介面元素工具提示和無法播放視訊時顯示的錯誤訊息。

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

取消選取的隱藏字幕按鈕狀態的工具提示。

SocialShare.TOOLTIP

社交分享工具的工具提示。

EmailShare.TOOLTIP

電子郵件分享按鈕的工具提示。

EmailShare.HEADER

電子郵件對話方塊標題的工具提示。

EmailShare.TOOLTIP_HEADER_CLOSE

電子郵件對話方塊右上關閉按鈕的工具提示。

EmailShare.INVALID_ADDRESSS

當電子郵件地址格式錯誤時顯示錯誤訊息的工具提示。

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

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

本頁內容