使用者介面元素的本地化 localization-of-user-interface-elements

混合媒體檢視器顯示的某些內容可能會進行本地化。 此建議包括縮放按鈕、迴轉按鈕、視訊控制項、關閉按鈕、全熒幕按鈕和色票捲動按鈕。

檢視器中可本地化的每個文字內容，都會以稱為SYMBOL的特殊檢視器SDK識別碼表示。 任何SYMBOL都有隨現成可用的檢視器提供的英文地區設定( "en")的預設相關文字值。 您也可以視需要為多個地區設定使用者定義的值。

當檢視器啟動時，它會檢查目前的地區設定，檢視地區設定的每個受支援SYMBOL是否有使用者定義的值。 如果有的話，它會使用使用者定義的值；否則，它會回覆成現成的預設文字。

使用者定義的本地化資料可作為本地化JSON物件傳遞至檢視器。 此類物件包含支援的語言環境清單、每個語言環境的SYMBOL文字值，以及預設語言環境。

以下是這類本地化物件的範例：

{
"en":{
"CloseButton.TOOLTIP":"Close",
"ZoomInButton.TOOLTIP":"Zoom In"
 },
 "fr":{
"CloseButton.TOOLTIP":"Fermer",
"ZoomInButton.TOOLTIP":"Agrandir"
},
defaultLocale:"en"
}

在上述範例中，本地化物件定義了兩個地區設定（"en"和"fr"），並為每個地區設定中的兩個使用者介面元素提供本地化。

網頁程式碼應將本地化物件作為設定物件之localizedTexts欄位的值傳遞給檢視器建構函式。 替代選項是呼叫setLocalizedTexts(localizationInfo)方法來傳遞本地化物件。

支援下列SYMBOL：