Brightcove プレーヤのバージョン 5.22.0 では、エラー コードが追加されました。動画プレーヤのコンテキストでは、エラーとは、再生が続行できず、再スタートするにはプレーヤ自身以外の何らかのアクションが必要な状態のことです。
新しいエラーコードにより、再生がブロックされる多くの一般的な（そしてしばしば意図的な）状況を、より簡単に検出できるようになります。他の Brightcove Player エラーと同様に、プレーヤにリスナーを設定することで、新しいエラー コードに対応できます。
// Listen for error events on a player instance:
player.on('error', function() {
// When your listener is invoked, check the error property on the player for details.
var error = player.error();
// Errors have a code and a message
console.log('Uh-oh...', error.code, error.message);
});新しいエラーコードは、メディアの制限による再生の失敗についての洞察を提供し、いくつかの一般的な統合の問題をデバッグしやすくします。全リストはこちら。
| コード | 説明 |
|---|---|
| PLAYER_ERR_DOMAIN_RESTRICTED | ドメイン制限のため、プレーヤーまたはデフォルトの動画を現在のページで実行できません。 |
| PLAYER_ERR_IP_RESTRICTED | デフォルトのビデオは、このユーザーのIPアドレスから許可されていません。 |
| PLAYER_ERR_GEO_RESTRICTED | デフォルトのビデオは、このユーザーの地域では利用できません。 |
| VIDEO_CLOUD_ERR_ACCOUNT_NOT_FOUND | 無効なアカウントIDが設定されています。 |
| VIDEO_CLOUD_ERR_RESOURCE_NOT_FOUND | デフォルトのプレイリストIDが無効です。 |
| VIDEO_CLOUD_ERR_VIDEO_NOT_FOUND | デフォルトのビデオは無効です。 |
新しいエラー・コードの多くは、プレーヤーで設定されたデフォルトの動画またはプレイリストに対してのみ表示されます。つまり videoId クエリパラメータまたは data-playlist-id 属性を使用します。カタログを使用してプログラムで動画を取得する場合も、レスポンスのコールバックでエラーをチェックし、そこで処理する必要があります。
5.22.0はすべての方にご利用いただけるようになり、自動アップデートを受信しているプレーヤーの皆様には順次配布されています。プレーヤーのエラーを収集および分析されている場合、新しいエラーコードが視聴者の体験をよりよく理解するのに役立つことを願っています（また、問題が発生した場合のエンドユーザーの混乱を軽減します）。
