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

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

ローカライズ可能なビューア内のテキストコンテンツは、すべて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	クローズドキャプションボタンが選択解除された状態のツールチップ。
SocialShare.TOOLTIP	ソーシャル共有ツールのツールチップ。
EmailShare.TOOLTIP	電子メール共有ボタンのツールチップ。
EmailShare.HEADER	電子メールダイアログヘッダーのツールチップ。
EmailShare.TOOLTIP_HEADER_CLOSE	電子メールダイアログボックスの右上にある閉じるボタンのツールチップ。
EmailShare.INVALID_ADDRESSS	電子メールアドレスの形式が正しくない場合に表示されるエラーメッセージのツールチップ。
EmailShare.TO	「宛先」入力フィールドのラベル。
EmailShare.TOOLTIP_追加	「追加別の電子メールアドレス」ボタンのツールチップ。
EmailShare.追加	「追加別の電子メールアドレス」ボタンのキャプション。
EmailShare.FROM	「送信者」入力フィールドのラベル。
EmailShare.MESSAGE	「メッセージ」入力フィールドのラベル。
EmailShare.TOOLTIP_REMOVE	「電子メールアドレスを削除」ボタンのツールチップ。
EmailShare.CANCEL	「キャンセル」ボタンのキャプション。
EmailShare.TOOLTIP_CANCEL	「キャンセル」ボタンのツールチップ。
EmailShare.CLOSE	フォームの送信後のダイアログの下部に表示される閉じるボタンのキャプション。
EmailShare.TOOLTIP_CLOSE	フォームの送信後のダイアログの下部に表示される閉じるボタンのツールチップ。
EmailShare.ACTION	フォームの送信ボタンのキャプション。
EmailShare.TOOLTIP_ACTION	フォームの送信ボタンのツールチップ。
EmailShare.SEND_SUCCESS	電子メールが正常に送信された場合に表示される確認メッセージ。
EmailShare.SEND_FAILURE	電子メールが正常に送信されなかった場合に表示されるエラーメッセージ。
EmbedShare.TOOLTIP	埋め込み共有ボタンのツールチップ。
EmbedShare.HEADER	埋め込みダイアログボックスヘッダーのツールチップ。
EmbedShare.TOOLTIP_HEADER_CLOSE	埋め込みダイアログボックスの右上にある閉じるボタンのツールチップ。
EmbedShare.DESCRIPTION	埋め込みコードテキストの説明。
EmbedShare.EMBED_SIZE	埋め込みサイズコンボボックスのラベル。
EmbedShare.CANCEL	「キャンセル」ボタンのキャプション。
EmbedShare.TOOLTIP_CANCEL	「キャンセル」ボタンのツールチップ。
EmbedShare.ACTION	「すべて選択」ボタンのキャプション。
EmbedShare.TOOLTIP ACTION	「すべて選択」ボタンのツールチップ。
EmbedShare.CUSTOM_SIZE	埋め込みサイズコンボボックスの最後の「カスタムサイズ」エントリのテキスト。
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共有ボタンのツールチップ。
VideoPlayer.ERROR	再生可能なビデオがない場合に表示されるエラーメッセージのツールチップ。