Brightcove プレーヤー エラー リファレンス

このドキュメントは Brightcove プレーヤーのエラーをまとめたものです。なお、エラーはさまざまなプラグインから発生する可能性があります。

エラーの種類

主に 6 種類のエラーがあり、このセクションではそれぞれを簡単に説明します。該当する場合は、エラータイプをクリックしてその種類に属する特定のエラーを確認することができます。

標準エラー

一般的に、メディア エラーはメディアの取得または再生中に問題が発生した場合に起こります。たとえば、ネットワーク接続が失われた場合や、復号できない暗号化された動画を取得した場合などです。詳細については、 標準エラー のセクションを Display Error Messages プラグイン ドキュメントでご確認ください。

コード タイプ 見出し メッセージ
1 MEDIA_ERR_ABORTED 動画のダウンロードがキャンセルされました メディアの再生を中止しました。
2 MEDIA_ERR_NETWORK 動画の接続が失われました。インターネットに接続されていることを確認してください。 ネットワーク エラーにより、メディアのダウンロードが途中で失敗しました。 現在、このエラーは主に MP4 またはプログレッシブ ダウンロード形式の動画に関して有効です。 詳細は 既知の問題 のセクションを Display Error Messages プラグイン ドキュメントでご確認ください。
3 MEDIA_ERR_DECODE 動画が壊れているか、ブラウザで再生できない形式です メディア再生は破損の問題、またはブラウザがサポートしていない機能を使用しているため中止されました。
4 MEDIA_ERR_SRC_NOT_SUPPORTED この動画は利用できないか、このブラウザではサポートされていません サーバーまたはネットワークの障害、または形式がサポートされていないため、メディアを読み込むことができませんでした。
5 MEDIA_ERR_ENCRYPTED 視聴しようとしている動画は暗号化されていますが、復号方法が不明です 視聴しようとしている動画は暗号化されていますが、復号方法が不明です。
不明 MEDIA_ERR_UNKNOWN N/A 予期しない問題が発生しました。しばらくしてからもう一度お試しください。

カスタム エラー

一般的に、プレーヤー エラーは動画が読み込まれたにもかかわらず、何らかの理由で再生できない場合に発生します。たとえば、ドメイン、地域（Geo）、または IP 制限により動画の視聴が制限されている場合、プレーヤー エラーが発生します。詳細については、 カスタム エラー のセクションを Display Error Messages プラグイン ドキュメントでご確認ください。

コード メッセージ 説明
-1 PLAYER_ERR_NO_SRC 動画が読み込まれていません。
-2 PLAYER_ERR_TIMEOUT 動画をダウンロードできません。デフォルトのタイムアウトは 45 秒です。
未設定 PLAYER_ERR_ACCOUNT_ID アカウント ID が存在しないか、無効です。
未設定 PLAYER_ERR_DOMAIN_RESTRICTED この動画は現在のドメインでの再生が制限されています。
未設定 PLAYER_ERR_IP_RESTRICTED この動画は現在の IP アドレスで制限されています。
未設定 PLAYER_ERR_GEO_RESTRICTED この動画は現在の地理的地域では再生が制限されています。
1 PLAYER_ERR_NO_SRC 動画が読み込まれていません。
未設定 PLAYER_ERR_OFFER_RESTRICTED 動画はお客様の利用権では再生できません。
未設定 PLAYER_ERR_TAG_RESTRICTED 動画には再生に必要なタグが含まれていません。
2 PLAYER_ERR_TIMEOUT 動画を 45 秒間（デフォルト）ダウンロードできませんでした。

カタログ エラー

一般的に、カタログ エラーは動画やプレイリストの取得、または初回再生時に問題が発生した場合に送出されます。たとえば、存在しない ID を使用した場合や、プレーヤーが存在する別のアカウントの ID を使用して動画を取得しようとした場合などに、カタログ エラーが発生します。詳細については、 カタログ エラー のセクションを Player Catalog ドキュメントでご確認ください。

カタログ エラー 説明
VIDEO_CLOUD_ERR_ACCOUNT_NOT_FOUND プレーヤーに無効な Video Cloud アカウント ID が設定されています。
VIDEO_CLOUD_ERR_ACCOUNT_RETRIEVE_FAILURE Video Cloud アカウントを利用できません。
VIDEO_CLOUD_ERR_RESOURCE_NOT_FOUND デフォルトのプレイリスト ID が無効です。
VIDEO_CLOUD_ERR_NOT_PLAYABLE Video Cloud 動画は再生できません。
よくある原因としては、動画 ID が無効化されている場合や、配信スケジュールの有効期限が切れている場合があります。
VIDEO_CLOUD_ERR_AD_CONFIG_ID_NOT_FOUND Video Cloud SSAI 広告設定 ID が見つかりません。
VIDEO_CLOUD_DENIED_BY_DEVICE_LIMITING このデバイスでのストリーム数が上限に達しました。
VIDEO_CLOUD_DENIED_BY_STREAM_LIMIT_CREATE 制限付きストリームの視聴者数が上限に達しました。
VIDEO_CLOUD_DENIED_BY_STREAM_LIMITING 制限付きストリームの視聴者数が上限に達しました。
VIDEO_CLOUD_DENIED_BY_STREAM_LIMIT_RENEW 制限付きストリームはすでに最大視聴者数で視聴されています。
VIDEO_CLOUD_ERR_DUPLICATE_PARAMETERS 同じパラメータ名がリクエスト内で複数回指定されました。
VIDEO_CLOUD_ERR_LICENSE_RETRIEVE_FAILURE ストリーム ライセンスを利用できません。
VIDEO_CLOUD_ERR_METHOD_NOT_ALLOWED API メソッドが許可されていません。
VIDEO_CLOUD_ERR_NOT_PLAYABLE Video Cloud 動画は再生できません。
VIDEO_CLOUD_ERR_OFFERS_RETRIEVE_FAILURE ストリーム オファーを利用できません。
VIDEO_CLOUD_ERR_PLAYBACK_RIGHT_RETRIEVE_FAILURE 利用権情報を取得できません。
VIDEO_CLOUD_ERR_PLAYLIST_NOT_FOUND プレイリストが見つかりません。
VIDEO_CLOUD_ERR_PLAYLIST_NOT_PLAYABLE このプレイリストは現在再生できません。
VIDEO_CLOUD_ERR_PLAYLIST_RETRIEVE_FAILURE 動画プレイリストを利用できません。
VIDEO_CLOUD_ERR_PLAYLIST_VIDEOS_RETRIEVE_FAILURE プレイリスト内の動画を利用できません。
VIDEO_CLOUD_ERR_RESOURCE_NOT_FOUND Video Cloud リソースが見つかりません。
VIDEO_CLOUD_ERR_RIGHTS_RETRIEVE_FAILURE ストリーム権利情報を利用できません。
VIDEO_CLOUD_ERR_SERVER 内部サーバーエラーにより再生ができませんでした。
VIDEO_CLOUD_ERR_SERVICE_TIMEOUT サーバーからタイムアウト応答を受け取りました。後でもう一度お試しください。
VIDEO_CLOUD_ERR_SERVICE_UNAVAILABLE サーバーは現在利用できません。後でもう一度お試しください。
VIDEO_CLOUD_ERR_TOKEN_INVALID 有効なトークンがないと動画を再生できません。
VIDEO_CLOUD_ERR_TOKEN_REQUIRED トークンがないと動画を再生できません。
VIDEO_CLOUD_ERR_VIDEO_NOT_FOUND デフォルト動画が無効です。
VIDEO_CLOUD_ERR_VIDEO_NOT_PLAYABLE 動画は現在再生できません。
VIDEO_CLOUD_ERR_VIDEO_RETRIEVE_FAILURE 動画は現在利用できません。
VIDEO_CLOUD_ERR_VIDEO_URLS_RETRIEVE_FAILURE ストリーム URL を利用できません。

HLS プラグインのエラー

詳細は、HLS Plugin ドキュメントの Errors セクションをご覧ください。

HLS プラグイン エラー 説明
APPEND_BUFFER_ERR ブラウザが HLS 動画の再生中にエラーを投げました。

QoE Analytics モジュール iOS エラー

コード 説明
69401 再生しようとしているコンテンツに関連付けられた FairPlay ライセンスに問題があることを示します。ライセンスの有効期限切れ、ライセンスの破損、ライセンスとデバイスまたはアプリの不一致など、さまざまな理由が考えられます。
69402 デバイスのライセンス要求に対して、FairPlay ライセンスサーバーが有効な応答を返せなかったことを示します。ネットワーク接続の問題、ライセンスサーバー側の問題、デバイスの証明書やセキュリティ設定の問題などが原因となり得ます。

再生制限エラー

Brightcove の再生制限に関連するエラーについては、Playback Restrictions Error Reference をご参照ください。

再生制限が初めての方は、Overview: Brightcove Playback Restrictions をご覧ください。

コンソール エラー

これらのエラーは、次のようなコンソールに表示されます。

Console error
コンソール メッセージ 解決策
VIDEOJS: ERROR: videojs-contrib-ads は初期化後 5 秒経過しても loadstart イベントを検出していませんが、ソースは存在します。これは videojs-contrib-ads の初期化が遅すぎたことを示します。video.js の直後、同じティックで初期化する必要があります。その結果、一部の広告が再生されず、一部のメディア イベントが正しくない可能性があります。詳細は https://github.com/videojs/videojs-contrib-ads#important-note-about-initialization を参照してください。 IMA3 プラグインを正しく機能させるには、プレーヤーの初期化直後に、他のプラグインより先に読み込む必要があるため、このメッセージが表示されます。解決策は、IMA3 Plugin ドキュメントの コードを使用した実装 セクションをご覧ください。

カスタム ユーザー エラー

詳細については、Display Error Messages プラグイン ドキュメントの カスタム エラーの追加 セクションをご覧ください。標準のカスタム ユーザー エラーはありません。

ネットワーク セキュリティ エラー

これらのエラーは、ネットワーク セキュリティによって一部の Brightcove ドメインやポートがブロックされた場合に発生します。

エラーコード 説明
FLASHLS_ERR_CROSS_DOMAIN 動画を読み込めませんでした：クロスドメインアクセスが拒否されました。
リクエスト元のドメイン（または '*'）を許可する crossdomain.xml ファイルをプレイリストファイルのルートに配置する必要がある場合があります。

GSC エラーコード

エラーコード 説明
GSC_ERR_DENIED_BY_CONCURRENCY_LIMITING この動画のセッション数が上限に達しており、同時視聴制限が適用されています。
GSC_SESSION_STOPPED プレーヤーが同時視聴制限ステータス（「ハートビート」）を確認するリクエストが複数回失敗した際に、このエラーが発生します。これは、ハートビート リクエストを遮断して同時視聴制限を回避することを防ぐために再生を強制停止します。
GSC_INVALID_TOKEN 提供された JWT が無効です。
GSC_PLAYBACK_RESTRICTIONS 指定された再生制限の要件が満たされていません。
GSC_SESSION_NOT_FOUND セッションが存在しないため、システムは存在しないセッションに対して同時視聴制限を適用できません。

エラーのリスニング

次のように on() メソッドを使用して、すべてのエラーを監視することもできます。

myPlayer.on('error'), function () {
        ...
      }

広告を再生しており、すべてのエラーをキャッチしたい場合は、次のようにします。

myPlayer.on(['error','aderror')], function () {
        ...
      }