[2024.11] VPE 1.1.3 민간/공공 업데이트

Video Player Enhancement 1.1.3 업데이트 내역 안내

업데이트 내역 안내

1. hls.js / dash.js 버전 업데이트

hls.js 1.4.10 → 1.5.14
dash.js 4.7.2 → 4.7.4

2. iOS 사파리 MediaSourceExtension 지원 (Hls.js 업데이트)

iOS는 MediaSourceExtension 지원하지 않아 사파리 내장 플레이어로 hls를 재생했습니다.

iOS 17.1.x 사파리부터 MediaSourceExtension 공식 지원
iOS에서 hls.js Tech 이용 가능, 타 OS와 동일한 환경에서 재생 가능 (단 풀스크린은 아직 커스텀 불가)

3. Retry 옵션 추가

플레이어 초기화 시 영상 재생 시도 추가 : 기본값 최대 3회 , 5초간격
라이브가 중단되었을때도 재생 시도 추가 : 기본값 최대 3회 , 5초 간격
옵션으로 횟수와 간격을 설정 가능

new ncplayer('video',{
      playlist:[
          {
            file:"https://dobdd7vj3864.edge.naverncp.com/hls/47NWZgkwsKFkPIU1tix9Zw__/endpoint/sample/221027_NAVER_Cloud_intro_Long_ver_AVC_,FHD_2Pass_30fps,HD_2Pass_30fps,SD_2Pass_30fps,.mp4.smil/master.m3u8",
            poster:"https://2ardrvaj2252.edge.naverncp.com/endpoint/sample/221027_NAVER_Cloud_intro_Long_ver_01.jpg",
          },

      ],
          retry:{
            maxRetry:10, //최대 retry 횟수
            interval:5000, //retry 당 지연시간 (ms)
        },
      }
  );

Retry 옵션

옵션	타입	기본값	설명
retry	Object
retry.maxRetry	Int	3	다시 시도 횟수
retry.interval	Int	5000	다시 시도 지연 시간(ms)

4. hls.js / dash.js 옵션 오버라이드 추가

VPE 는 hls.js / dash.js 플레이어 라이브러리 이용하서 영상을 재생합니다.
각각 라이브러리에서 사용되는 옵션을 별도로 적용할 수 있습니다.

new ncplayer('video',{
      playlist:[
          {
            file:"https://dobdd7vj3864.edge.naverncp.com/hls/47NWZgkwsKFkPIU1tix9Zw__/endpoint/sample/221027_NAVER_Cloud_intro_Long_ver_AVC_,FHD_2Pass_30fps,HD_2Pass_30fps,SD_2Pass_30fps,.mp4.smil/master.m3u8",
            poster:"https://2ardrvaj2252.edge.naverncp.com/endpoint/sample/221027_NAVER_Cloud_intro_Long_ver_01.jpg",
          },

      ],
      dashjsConfig:{ //dashjs options
          debug: {
             logLevel: dashjs.Debug.LOG_LEVEL_NONE  //dash.js 디버깅
          },
      },
      hlsjsConfig:{  //hlsjs options
          debug:true, // ex) hls.js 디버깅
        },
      }
  );

오버라이드 옵션

옵션	타입	기본값	설명
dashjsConfig	Object	null	https://dashjs.org/
hlsjsConfig	Object	null	https://hlsjs.video-dev.org/api-docs/hls.js.hls

5. 그밖에 버그 수정

모바일 UI에 자막이 추가 되어도 option.ui 설정이 우선시되어 버튼이 안나오는 버그가 수정되었습니다.
커스텀 버튼 위치 겹치는 버그가 수정되었습니다.
네이티브 SDK 관련 아래 버그들이 수정되었습니다.
- iOS 디바이스 회전시 풀스크린 → 회전 복귀 시 UI 오류
- iOS 일부 17.5 버전에서 동영상 재생 실패 수정
- 안드로이드 PIP 버그 수정 및 코드 리팩토링
- 네이티브 SDK에 JS SDK 내재화로 초기 로딩 개선