プレーヤのエラー メッセージをローカライズする

Product
Video Cloud
対象となる役割
開発者
バージョン
Brightcove 5
モジュール
Player API
エディション
Pro, Enterprise

地理的またはドメイン上の制約や、コンテンツの使用不可などの理由により、Brightcove プレーヤをロードできない場合は、ページにはそれに対応するエラー メッセージが表示されます。デフォルトでは、これらのエラー メッセージは英語です。プレーヤのエラー メッセージをローカライズするには、以下の手順を実行します。

カスタマイズされたエラー メッセージ ファイルを作成します

デフォルトの英語のエラー メッセージ ファイルは、次のようなものです。

<errors>
  <domainRestricted>
視聴しようとしている動画は、この Web サイトからは視聴できません。
  </domainRestricted>
  <geoRestricted>
視聴しようとしている動画は、お客様が現在いらっしゃる国または場所からは視聴できません。
  </geoRestricted>
  <invalidID>
視聴しようとしている動画は、この Web サイトからはもう利用できません。
  </invalidID>
  <default>
視聴しようとしている動画は、現在利用できません。少ししてからチェックしてください。
  </default>
</errors>

エラー メッセージ タグ内のテキストは、任意の言語または文字セットを用いて自由に変更できます。

(ビデオではなく)プレーヤーにドメイン制限あるいは地域制限がある場合に、domainRestricted および geoRestricted エラーメッセージが表示されます。domain restriction または geo-restrictionについてもっと詳細を見る。

パブリッシング コードにエラー メッセージ URL を設定する

プレーヤで、デフォルトの英語のエラー メッセージ以外のエラー メッセージを表示するよう設定するには、プレーヤのパブリッシング コードで localizedErrorXML プレーヤ構成パラメータを設定します。JavaScript/HTML を使用してこのパラメータを設定するには、パブリッシング コードの <object> 要素で、次のようなパラメータを使用します。

<param name="localizedErrorXML" value="http://myserver.com/klingon/localizedError.xml" />

ActionScript を使用してこのパラメータを設定するには、パブリッシング コードの init 関数で、次のようなパラメータを使用します。

config["localizedErrorXML"] = "http://myserver.com/klingon/localizedError.xml";

URL は、相対 URL ではなく絶対 URL でなくてはなりません。

タグ
language, localization