使用者介面元素的本地化
最後更新: 2024年7月22日
建立對象:
- 開發人員
- 使用者
檢視器顯示的某些內容可能會經過本地化。 這類內容包含使用者介面元素工具提示,以及在視訊無法播放時顯示的錯誤訊息。
檢視器中可本地化的每個文字內容,都會以稱為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:
符號 | 工具提示…… |
---|---|
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 | 全熒幕狀態的全熒幕按鈕。 |
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 | 無法播放視訊時顯示的錯誤訊息。 |