用戶介面元素本地化

檢視器顯示的特定內容會受本地化規範。 這些內容包括用戶介面元素工具提示和當視頻無法播放時顯示的錯誤消息。

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

無法播放視訊時顯示的錯誤訊息。

本頁內容