エラー対応

Classic/VPC環境で利用できます。

エラー対応では、スクリプトコードを修正して Errorイベントを通じて再生ソースにユーザー定義メッセージを適用する方法について説明します。

JS Errorイベントのご案内

プレイヤーを呼び出す関数で player.on("error", (err) => {});コードにてイベントを検知し、エラーコードとメッセージを呼び出すことができます。

ユースケースは次の通りです。

function createPlayer(id) {
    let player = new ncplayer('video', {
        { 
            file:"http://example.com/myVideo.mp4",
            poster:"http://example.com/myVideoThumb.png" 
        },
    });
    
    player.on("error", (err) => {
        const error_code = err.code;
        switch (error_code) {
            case "E0001":
                console.log("E0001 - ACCESS DENIED");
                console.log("正しくないアクセス/正しくないオプション値が転送された場合に発生", err);
                break;
            case "E0002":
                console.log("E0002 - NOT AUTHORIZED");
                console.log("動画の再生権限なし/正しくないリクエストでプレイヤー認証が失敗した場合に発生", err);
                break;
            case "E0003":
                console.log("E0003 - NETWORK ERROR");
                console.log("認証失敗/ネットワーク接続問題で発生", err);
                break;
            case "E0004":
                console.log("E0004 - CANNOT PLAY");
                console.log("動画再生が不可能/動画ファイルの再生に失敗する場合に発生", err);
                break;
            case "E0005":
                console.log("E0005 - LICENSE IS INVALID");
                console.log("ライセンスが有効ではありません/ライセンスが有効期限切れになった場合に発生", err);
                break;
            case "E0006":
                console.log("E0006 - LIMIT DENIED");
                console.log("月間基本提供呼び出し量を超過/無料プレイヤーの月間使用量を使い切った場合に発生", err);
                break;
            default:
                break;
        }
    });
}

エラー画面のオーバーライド(Override)

基本的に提供されるエラー画面を顧客会社が希望するコードに変更して実行できます。
エラー画面をオーバーライドすると、次の変更画面のように最後の再生位置で停止(pause)状態を維持したままプレイヤーオーバーレイでエラー画面を実装できます。

ユースケースは次の通りです。

// 動画(MP4)
const player = new ncplayer('video', {
    playlist: [
        {
            file: 'https://CDNドメイン/example_video_01.mp4',
            poster: 'https://CDNドメイン/example_image_01.png',
        }
    ],
    override:{
        error(err){
            console.log('player error :', err);
            // 顧客会社のエラー画面機能の実装
            // 例) documnet.getElementById('error').style.display = 'block';
        },
    }
});

エラーコード

Video Player Enhancementサービスが提供するエラーコードリストは、次の通りです。