インタラクティブビデオビューアに表示されるコンテンツには、ローカリゼーションの対象となるものもあります。 このようなコンテンツには、ユーザーインターフェイス要素のツールチップや、ビデオを再生できないときに表示されるエラーメッセージなどが含まれます。
ビューア内のテキスト内容がローカライズ可能な場合は、それぞれ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)
メソッドを呼び出してローカライゼーションオブジェクトを渡す方法があります。
次のシンボルがサポートされています。
シンボル |
ツールチップ |
---|---|
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 |
全画面表示状態のフルスクリーンボタン。 |
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 |
再生可能なビデオがない場合に表示されるエラーメッセージ。 |