ユーザーインターフェイス要素のローカライゼーション

インタラクティブビデオビューアで表示されるコンテンツには、ローカライゼーションの対象となるものもあります。 例えば、ユーザーインターフェイス要素のツールチップや、ビデオを再生できない場合に表示されるエラーメッセージが表示されます。

ローカライズ可能なビューア内のテキストコンテンツは、すべてSYMBOLと呼ばれる特別なビューアSDK識別子で表されます。 すべてのシンボルには、標準搭載のビューアに付属の英語ロケール("en")に対するデフォルトの関連テキスト値があり、また、必要な数のロケールに対してユーザ定義値を設定できます。

ビューアの開始は、現在のロケールをチェックして、そのロケールでサポートされている各シンボルに対してユーザ定義値があるかどうかを確認します。 存在する場合は、ユーザー定義の値が使用されます。それ以外の場合は、そのまま使用できるデフォルトのテキストに戻ります。

ユーザ定義のローカライゼーションデータは、ローカライゼーションJSONオブジェクトとしてビューアに渡すことができます。 このオブジェクトには、サポートされるロケールのリスト、各ロケールのシンボルテキスト値、およびデフォルトロケールが含まれます。

このようなローカライゼーションオブジェクトの例を次に示します。

{ 
"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)メソッドを呼び出してローカライゼーションオブジェクトを渡すこともできます。

次のシンボルがサポートされています。

シンボル

ツールチップの対象

コンテナ.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

フルスクリーン状態でのフルスクリーンボタン。

ClosedCaptionButton.TOOLTIP_SELECTED

クローズドキャプションボタンが選択された状態。

ClosedCaptionButton.TOOLTIP_UNSELECTED

クローズドキャプションボタンが選択解除された状態。

InteractiveSwatches.BANNER

バナーのキャプション。

ScrollUpButton.TOOLTIP

上スクロールボタン。

ScrollDownButton.TOOLTIP

下スクロールボタン。

SocialShare.TOOLTIP

ソーシャル共有ツール。

LinkShare.TOOLTIP

リンク共有ボタン。

LinkShare.HEADER

リンクダイアログボックスのヘッダー。

LinkShare.TOOLTIP_HEADER_CLOSE

リンクダイアログボックスの右上の閉じるボタン。

LinkShare.DESCRIPTION

共有リンクの説明。

LinkShare.CANCEL

「キャンセル」ボタンのキャプション。

LinkShare.TOOLTIP_CANCEL

キャンセルボタン。

LinkShare.ACTION

「すべて選択」ボタンのキャプション。

LinkShare.TOOLTIP_ACTION

「すべて選択」ボタン。

FacebookShare.TOOLTIP

Facebookの共有ボタン。

TwitterShare.TOOLTIP

Twitterの共有ボタン。

CloseButton.TOOLTIP

アクションを呼び出しパネルの閉じるボタン。

VideoPlayer.ERROR

再生可能なビデオがない場合に表示されるエラーメッセージ。

このページ