メインコンテンツまでスキップ

3XXX (Web Player/HTML5 Player for All エラー)

Web Player (v5) および HTML5 Player for All (v4) で発生するエラーコードです。error イベント発生時に get_error_detail() メソッドでコードを確認します。

controller.on('error', function() {
  var detail = controller.get_error_detail();
  console.error('Error code:', detail.code, detail.message);
});

3000​

  • エラーコード: 3000
  • タイプ: ERROR_API_CONNECTION
  • 概要: プレイヤー初期化時の Kollus サーバー API 呼び出し失敗

原因​

  • ユーザーのインターネットネットワークが一時的に切断された場合です。
  • Kollus サーバーインフラに一時的な障害が発生した場合です。
  • サービスサイトの CSP（コンテンツセキュリティポリシー）により、Kollus の通信ドメインがブロックされている状態です。

解決方法​

  • ユーザーのインターネットネットワーク接続状態を確認した後、ブラウザページを再読み込みしてください。
  • お客様のサービスウェブサイトに CSP が設定されている場合は、ファイアウォールおよびセキュリティホワイトリストに *.kollus.com ドメインが正常に許可されているか確認してください。

3001​

  • エラーコード: 3001
  • タイプ: MEDIA_ERR_ABORTED
  • 概要: ユーザーまたはブラウザによる再生キャンセル

原因​

ユーザーが動画を視聴中にブラウザタブを切り替えたり、別のページへ移動（ナビゲーション）するなど、意図した操作によりメディアの読み込みが中断される現象です。ほとんどの場合は正常なサービス利用フローであるため、別途の例外エラー処理を構成する必要はありません。

3002​

  • エラーコード: 3002
  • タイプ: MEDIA_ERR_NETWORK
  • 概要: 動画再生中のネットワーク接続切断

解決方法​

ネットワーク再接続を検知した後、システムが自動的に再生を再試行するか、ユーザー UI 画面に手動再試行ボタンを提供するロジックを実装してください。

controller.on('error', function() {
  var detail = controller.get_error_detail();
  if (detail.code === 3002) {
    showRetryButton();
  }
});

3005​

  • エラーコード: 3005
  • タイプ: MEDIA_ERR_ENCRYPTED
  • 概要: 現在の再生環境で暗号化コンテンツが非対応

原因​

  • 非暗号化コンテンツ専用である HTML5 Player for All (v4) 環境で、DRM セキュリティポリシーが適用された暗号化コンテンツの再生を試みた場合です。
  • ユーザーが利用中のウェブブラウザ環境が EME（Encrypted Media Extensions）機能をサポートしていない旧式のブラウザである場合です。

解決方法​

暗号化（DRM）コンテンツは HTML5 Player for PC（Hybrid）または Multi-DRM 環境で再生する必要があります。

  • HTML5 Player for PC (Hybrid): Microsoft Edge または Chrome 45 以上で暗号化コンテンツを再生する際に適用されるハイブリッド形式の HTML5 プレイヤー製品群です。

3008​

  • エラーコード: 3008
  • タイプ: ERROR_DUPLICATE_PLAYER
  • 概要: 同一ページ内で 2 つ以上のプレイヤーの重複実行を検知

原因​

  • 単一のウェブページ内にプレイヤー呼び出し用の iframe 要素を複数挿入した場合です。
  • SPA（Single Page Application）開発環境で、既存のプレイヤーコンポーネントを完全にアンマウント（Unmount）しないまま新しいプレイヤーインスタンスを同時にマウントした場合です。

解決方法​

1 つのウェブページ内では必ず単一のプレイヤーインスタンスのみが有効になるよう構造を制御してください。 プレイヤーを切り替える際は、以前使用していたプレイヤーオブジェクトの dispose() メソッドを先に呼び出して、メモリから完全に解放する必要があります。

controller.dispose();
// Create a new player instance

3012​

  • エラーコード: 3012
  • タイプ: MEDIA_ERR_LIVE_NOT_BROADCASTING
  • 概要: 進行中のライブ配信なし

原因​

リクエストしたライブチャンネルが現在リアルタイム配信中でないか、ライブ配信スケジュールが完全に終了した状態でアクセスを試みた場合に発生します。

解決方法​

ユーザー画面に該当ライブ講義の予定日時を案内するガイドメッセージを表示するか、配信開始後にブラウザ画面を再読み込みして再入場するよう案内を構成してください。

3013​

  • エラーコード: 3013
  • タイプ: ERROR_DUPLICATION_BLOCK_OR_EXPIRED_TIME_MEDIA_KEY
  • 概要: [Live 専用] 重複再生遮断または再生許可時間の失効

原因​

  • 重複再生遮断: 同一のユーザー識別子（client_user_id）データを使用するセッションが、別のデバイスやブラウザですでにアクティブになり動画を視聴中の状態です。
  • 再生許可時間の失効: JWT の expt 設定値またはメディアキーの有効期限（TTL）が完全に失効した状態です。

診断​

get_error_detail().message の結果値を通じて、上記 2 つの詳細原因のどちらのケースに該当するか確認します。

解決方法​

  • 重複再生遮断のケース: ユーザー画面に"他のデバイスですでに再生中です。"などの案内警告ポップアップを表示してください。
  • 再生許可時間失効のケース: JWT 認証トークンを新たに発行して再生を再リクエストしてください。

3015​

  • エラーコード: 3015
  • タイプ: ERROR_CONCURRENTLY_VIEWER_LIMIT
  • 概要: 同時接続人数超過

原因​

Kollus Live コンソールのライブチャンネル設定に指定された最大同時視聴者数の閾値（上限）を超えてトラフィックが流入した場合です。主に大規模ユーザーが集中するリアルタイムライブ配信環境で発生します。

解決方法​

  • ユーザー案内ポップアップの表示: 画面に"現在アクセスが集中しており、視聴が遅延しています。しばらくしてから再度お試しください。"などの案内メッセージポップアップを表示してください。
  • 自動再試行ロジック実装のヒント: 同時リクエスト集中（Thundering Herd）現象を防ぐために、即時再試行の代わりにリクエスト間隔を段階的に延ばす指数バックオフ（Exponential Backoff）アルゴリズム方式を適用することを推奨します。

3019​

  • エラーコード: 3019
  • タイプ: ERROR_DETECT_MANIPULATION
  • 概要: プレイヤーデータの改ざん検知

原因​

プレイヤー関連データの改ざんが検知された場合、セキュリティ脅威とみなしてビデオ再生プロセスを即座にブロックします。通常の一般視聴者環境ではほとんど発生しません。