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

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

ローカライズ可能なビューア内のテキストコンテンツは、すべて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

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

このページ