ユーザーインターフェイス要素のローカライズ localization-of-user-interface-elements
インタラクティブビデオビューアに表示される特定のコンテンツは、ローカライズの対象となります。 このようなコンテンツには、ユーザーインターフェイス要素のツールヒントと、ビデオが再生できないときに表示されるエラーメッセージが含まれます。
ローカライズ可能なビューア内のすべてのテキストコンテンツは、SYMBOLと呼ばれる特別なビューアSDK IDで表されます。 任意のSYMBOLには、標準ビューアで指定された英語ロケール （"en"）のデフォルトの関連テキスト値があります。 また、必要な数のロケールに対してユーザー定義の値を設定することもできます。
ビューアが起動すると、現在のロケールをチェックして、そのようなロケールでサポートされている各SYMBOLにユーザー定義の値があるかどうかを確認します。 存在する場合は、ユーザー定義の値を使用します。それ以外の場合は、デフォルトのデフォルトのテキストにフォールバックします。
ユーザー定義のローカライゼーションデータは、ローカライゼーション JSON オブジェクトとしてビューアに渡すことができます。 このオブジェクトには、サポートされているロケールのリスト、各ロケールのSYMBOL テキスト値、およびデフォルトのロケールが含まれます。
そのようなローカライゼーションオブジェクトの例を以下に示します。
{
"en":{
"VideoPlayer.ERROR":"Your Browser does not support HTML5 Video tag or the video cannot be played.",
"PlayPauseButton.TOOLTIP_SELECTED":"Play"
},
"fr":{
"VideoPlayer.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"
}
上記の例では、ローカライゼーションオブジェクトは2つのロケール（"en"と"fr"）を定義し、各ロケールの2つのユーザーインターフェイス要素にローカライゼーションを提供します。
Web ページのコードは、ローカライゼーションオブジェクトを、設定オブジェクトのlocalizedTexts フィールドの値としてビューアコンストラクターに渡す必要があります。 別のオプションとして、setLocalizedTexts(localizationInfo) メソッドを呼び出してローカライゼーションオブジェクトを渡すこともできます。
次のシンボルがサポートされています。