檢視器顯示的某些內容可能會受到本地化的規範。 這包括使用者介面元素工具提示,以及當視訊無法播放時顯示的錯誤訊息。
檢視器中可本地化的每個文字內容,都會以稱為SYMBOL的特殊檢視器SDK識別碼來表示。 任何SYMBOL都具有隨附於現成檢視器的英文地區("en"
)的預設相關文字值。 它也可能會根據需要設定使用者定義的值。
當檢視器啟動時,會檢查目前的地區設定,以查看地區設定中每個支援的SYMBOL是否都有使用者定義的值。 若有,則使用使用者定義的值;否則,它會回到預設的預設文字。
使用者定義的本地化資料可以作為本地化JSON物件傳遞至檢視器。 此類對象包含支援的語言環境清單、每個語言環境的SYMBOL文本值以及預設語言環境。
此類本地化對象的示例如下:
{
"en":{
"Video360Player.ERROR":"Your Browser does not support HTML5 Video tag or the video cannot be played.",
"PlayPauseButton.TOOLTIP_SELECTED":"Play"
},
"fr":{
"Video360Player.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 |
全螢幕按鈕,全螢幕狀態。 |
SocialShare.TOOLTIP |
社交分享工具。 |
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分享按鈕。 |
Video360Player.ERROR |
當無法播放視訊時出現的錯誤訊息。 |