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