에러 대응

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;
        }
    });
}

에러 시 Retry 환경 설정

플레이어의 재시도 설정을 통해 플레이어가 오류를 응답하기 전 최대 재시도 횟수 및 최대 지연 시간 설정을 커스터마이징 할 수 있습니다.

• Retry 옵션을 통한 재 정의 예제는 아래와 같습니다.

new ncplayer('video', {
    playerlist:[
        {
            file:"https://dobdd7vj3864.edge.naverncp.com/hls/47NWZgkwsKFkPIU1tix9Zw__/endpoint/sample/example.mp4.smil/master.m3u8",
            poster:"https://2ardrvaj2252.edge.naverncp.com/endpoint/sample/221027_NAVER_Cloud_intro_Long_ver_01.jpg",
        },
    ],
        retry:{
            maxRetry:10, //최대 재시도 횟수
            interval:5000, //재시도 횟수 당 지연 시간 (ms)
        },
    },
);

에러 화면 재정의(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 서비스에서 제공하는 에러 코드 목록은 다음과 같습니다.