---
title: "재생 설정"
slug: "vpe-example-play"
updated: 2026-05-21T09:01:50Z
published: 2026-05-21T09:03:18Z
canonical: "guide-gov.ncloud-docs.com/vpe-example-play"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://guide-gov.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 재생 설정

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

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

참고

- 옵션을 설정하는 속성에 대한 설명은 [플레이어 설정](/docs/vpe-web#%ED%94%8C%EB%A0%88%EC%9D%B4%EC%96%B4%EC%84%A4%EC%A0%95)을 참고해 주십시오.
- 이용 중인 요금제에 따라 설정할 수 있는 옵션에 차이가 있습니다.

## 자동 재생

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

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

참고

웹 페이지가 시작됨과 동시에 소음이 나거나 영상이 재생되면 사용자가 불편함을 느낄 수도 있습니다. 이를 방지하기 위해 특정 조건을 충족하는 경우에만 자동 재생되도록 제한합니다. 다음 조건을 하나 이상 충족해야 합니다.

- 음소거되거나 볼륨이 0일 때
- 클릭, 터치, 키 입력 등 웹 페이지에서 사용자의 입력이 있고 난 후
- 환경 설정에서 화이트 리스트 페이지로 설정된 경우
- 자동 재생을 지원하는 `<iframe>`과 해당 문서가 설정된 경우

## 자동 정지

`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를 제공할 수 있습니다.

참고

이 옵션은 Standard 요금제를 이용 중인 경우에만 설정할 수 있습니다.

예제는 다음과 같습니다.

```
// 동영상(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',
    },
  ],
});
```

## 반복 재생

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

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

## 최초 공개일 설정

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

참고

- 이 옵션은 Standard 요금제를 이용 중인 경우에만 설정할 수 있으며 VOD에만 적용할 수 있습니다.
- 날짜 포맷은 UTC 형식을 지원합니다.

예제는 다음과 같습니다.

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