에러 대응
    • PDF

    에러 대응

    • PDF

    기사 요약

    Classic/VPC 환경에서 이용 가능합니다.

    에러 대응에서는 스크립트 코드를 수정하여 Error 이벤트를 통해 재생 소스에 사용자 정의 메시지를 적용하는 방법을 설명합니다.

    참고

    Video Player Enhancement 서비스와 함께 Media Analytics 서비스를 이용하면 Media Analytics 관리 페이지에서 에러 코드를 손쉽게 확인할 수 있습니다.

    JS Error 이벤트 안내

    플레이어를 호출하는 함수에서 player.on("error", (err) => {}); 코드로 이벤트를 감지하여 에러 코드와 메시지를 호출할 수 있습니다.

    참고

    에러 코드는 Video Player Enhancement 서비스에서 제공하는 에러 코드 목록으로 전달합니다. 자세한 내용은 에러 코드를 참고해 주십시오.

    예제는 다음과 같습니다.

    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 환경 설정

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

    참고

    기본값은 아래와 같습니다.

    • 플레이어 초기화 시 영상 재생 시도 추가 : 기본값 최대 3회 , 5초 간격
    • Live / VOD 가 중단되었을 때도 재생 시도 추가 : 기본값 최대 3회 , 5초 간격
    • 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)
            },
        },
    );
    
    옵션타입기본값설명
    retryObject
    retry.maxRetryInt3다시 시도 횟수
    retry.intervalInt5000다시 시도 지연 시간 (ms)

    에러 화면 재정의(Override)

    기본으로 제공되는 에러 화면을 고객사가 원하는 코드로 변경하여 실행할 수 있습니다.
    에러 화면을 재정의하면 다음의 변경 화면과 같이 마지막 재생 위치에서 정지(pause) 상태를 유지한 채 플레이어 오버 레이어를 통해 에러 화면을 구현할 수 있습니다.
    image-EFN2HNB7

    예제는 다음과 같습니다.

    // 동영상(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 서비스에서 제공하는 에러 코드 목록은 다음과 같습니다.

    에러 번호에러 코드에러 메시지설명
    E0001ACCESS DENIED잘못된 접근입니다.잘못된 옵션 값이 전달되는 경우 발생하며, 동영상 재생 불가
    E0002NOT AUTHORIZED동영상을 재생할 권한이 없습니다.잘못된 요청으로 플레이어 인증이 실패하는 경우 발생
    E0003NETWORK ERROR네트워크 연결이 원활하지 않습니다.네트워크 문제로 플레이어 인증이 실패하는 경우 발생
    E0004CANNOT PLAY VIDEO동영상을 재생할 수 없습니다.영상 재생에 실패하는 경우 발생
    E0005LICENSE IS INVALID라이선스가 유효하지 않습니다.플레이어 라이선스가 만료되었을 때 발생하며, 동영상 재생 불가
    E0006LIMIT DENIED월 기본 제공 호출 건수를 초과하였습니다.무료 플레이어의 월 제공량을 모두 소진한 경우 발생하며, 동영상 재생 불가

    이 문서가 도움이 되었습니까?

    What's Next
    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.