재생 설정

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

재생 설정에서는 스크립트 코드를 수정하여 플레이어 재생과 관련한 옵션을 설정하는 방법을 설명합니다.

자동 재생

autostart 속성으로 플레이어의 재생 소스를 자동 재생할 수 있습니다. 예제는 다음과 같습니다.

// 동영상(MP4)
new ncplayer('video1', {
  autostart: true, // 자동 재생(false: 자동 재생 안 함)
  playlist: [
    {
      file: 'https://CDN도메인/example_video_01.mp4',
    },
  ],

자동 정지

autoPause 속성으로 브라우저 창이 최소화되거나 탭이 전환될 때 플레이어의 재생 소스를 자동 정지할 수 있습니다. 예제는 다음과 같습니다.

// 동영상(MP4)
new ncplayer('video1', {
  autoPause: true, // 자동 정지(false: 자동 정지 안 함)
  playlist: [
    {
      file: 'https://CDN도메인/example_video_01.mp4',
    },
  ],
});

음소거

muted 속성으로 플레이어를 처음 재생 시 음소거 상태로 재생할 수 있습니다. 예제는 다음과 같습니다.

// 동영상(MP4)
new ncplayer('video1', {
  muted: true, // 처음 재생 시 음소거(false: 음소거 안 함)
  playlist: [
    {
      file: 'https://CDN도메인/example_video_01.mp4',
    },
  ],
});

재생 속도

playbackRate 속성으로 재생 속도를 조절할 수 있습니다. 재생 속도를 지정하지 않은 경우에는 기본값으로 '1.0'이 적용됩니다. 1.0보다 작은 수를 입력하여 재생 속도를 느리게 설정하거나 높은 수를 입력하여 재생 속도를 빠르게 설정할 수 있습니다.
재생 속도를 0.5로 설정하는 예제는 다음과 같습니다.

// 동영상(MP4)
new ncplayer('video1', {
  muted: true,
  playbackRate: 0.5, // 재생 속도 조절(기본값: 1.0)
  playlist: [
    {
      file: 'https://CDN도메인/example_video_01.mp4',
    },
  ],
});

재생 속도 조절 UI

playRateSetting 속성으로 사용자가 재생 속도를 직접 설정할 수 있도록 UI를 제공할 수 있습니다.

예제는 다음과 같습니다.

// 동영상(MP4)
new ncplayer('video1', {
  muted: true,
  playRateSetting: [0.5,0.75,1.0,1.25,1.5,1.75,2.0], // 0.5배속 ~ 2배속 지원
  playlist: [
    {
      file: 'https://CDN도메인/example_video_01.mp4',
    },
  ],
});

초저지연 모드(LL-HLS)

lowLatencyMode 속성으로 Low Latency HLS에 최적화된 플레이어를 적용할 수 있습니다.

예제는 다음과 같습니다.

// 동영상(HLS)
new ncplayer('video1', {
  playlist: [
    {
      file: 'https://CDN도메인/example_video_01.mp4/index.m3u8',
    },
  ],
	lowLatencyMode: true, // LL-HLS 사용(false: LL-HLS 사용 안 함)
});

반복 재생

repeat 속성으로 영상을 반복 재생할 수 있습니다. 예제는 다음과 같습니다.

// 동영상(MP4)
new ncplayer('video1', {
  repeat: true, // 반복 재생(false: 반복 재생 안 함)
  playlist: [
    {
      file: 'https://CDN도메인/example_video_01.mp4',
    },
  ],
});

최초 공개일 설정

setStartTime 속성으로 라이브 방송처럼 VOD를 모든 사용자가 동시에 동일 구간을 시청하도록 설정할 수 있습니다.

예제는 다음과 같습니다.

// 동영상(MP4)
new ncplayer('video1', {
  autoPause: true,
  playlist: [
    {
      file: 'https://CDN도메인/example_video_01.mp4',
    },
  ],
	setStartTime:"2023-02-08 06:07:00+00:00", // 최초 공개일 설정
});