用戶介面元素的本地化

檢視器顯示的某些內容可能會受到本地化的規範。這包括使用者介面元素工具提示，以及當視訊無法播放時顯示的錯誤訊息。

檢視器中可本地化的每個文字內容，都會以稱為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	當無法播放視訊時出現的錯誤訊息。