---
title: "플레이어 생성 및 관리"
slug: "vpe-player"
tags: ["sdk", "Video Player", "Video Player Enhancement", "VPE", "배포"]
updated: 2026-09-17T09:08:00Z
published: 2026-09-17T09:08:00Z
canonical: "guide.ncloud-docs.com/vpe-player"
stale: true
---

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

# 플레이어 생성 및 관리

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

플레이어 생성 및 관리에서는 네이버 클라우드 플랫폼 콘솔의 **Video Player Management** 메뉴에서 플레이어를 생성하는 방법과 플레이어를 설정, 수정, 배포, 삭제하는 방법을 설명합니다. 또한 SDK 주소를 확인하고 SDK를 다운로드하는 방법을 설명합니다.

## 플레이어 생성

플레이어를 생성하는 방법은 다음과 같습니다.

              참고

              

Basic 요금제의 경우 플레이어를 1개만 생성할 수 있습니다. 플레이어를 2개 이상 생성하려면 [Standard 요금제로 전환](/docs/vpe-start#%EC%9C%A0%EB%A3%8C%EC%9A%94%EA%B8%88%EC%A0%9C%EC%A0%84%ED%99%98)해 주십시오.

1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Media** > **Video Player Enhancement** 메뉴를 차례대로 클릭해 주십시오.
2. **Video Player Management** 메뉴를 클릭해 주십시오.
3. **[생성하기]** 버튼을 클릭해 주십시오.
4. 플레이어 생성 화면이 나타나면 플레이어 기본 정보를 입력해 주십시오.
  - **플레이어 이름**: 플레이어를 관리하기 위한 이름 입력
    - 영어로 시작해야 하며, 영문자, 숫자, 특수문자(_, -, @)를 조합하여 3~30자 이내로 입력해 주십시오.
  - **사이트 도메인**: 도메인 유효성 체크를 위해 플레이어가 노출될 사이트 URL 입력
  - **앱 패키지ID**: 모바일 SDK 버전 사용을 위한 앱 패키지 ID 입력
  - **SDK 버전**: 사용할 SDK 버전 선택
5. **[생성하기]** 버튼을 클릭해 주십시오.
6. 플레이어 생성 팝업 창의 **[확인]** 버튼을 클릭해 주십시오.
  - 플레이어가 생성되어 목록에 표시됩니다.

## 플레이어 설정

플레이어 옵션을 설정하는 방법은 다음과 같습니다.

              참고

              

- 여기에서는 네이버 클라우드 플랫폼 콘솔에서 플레이어 옵션을 설정하는 방법을 설명합니다. 스크립트 코드를 직접 수정하여 플레이어 옵션을 좀 더 세부적으로 설정하려면 이 가이드에서 제공하는 플레이어 설정 스크립트를 참고해 주십시오.
- Basic 요금제의 경우 콘솔에서 재생 소스만 설정할 수 있습니다. 콘솔에서 다양한 옵션을 설정하려면 [Standard 요금제로 전환](/docs/vpe-start#%EC%9C%A0%EB%A3%8C%EC%9A%94%EA%B8%88%EC%A0%9C%EC%A0%84%ED%99%98)해 주십시오.

1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Media** > **Video Player Enhancement** 메뉴를 차례대로 클릭해 주십시오.
2. **Video Player Management** 메뉴를 클릭해 주십시오.
3. 플레이어 목록에서 옵션을 설정할 플레이어의 **[옵션 설정]** 버튼을 클릭해 주십시오.
4. 설정할 옵션에 따라 다음을 확인해 주십시오.
  - [재생 소스](/docs/vpe-player#%EC%9E%AC%EC%83%9D%EC%86%8C%EC%8A%A4)
  - [재생 설정](/docs/vpe-player#%EC%9E%AC%EC%83%9D%EC%84%A4%EC%A0%95)
  - [플레이어 UI](/docs/vpe-player#%ED%94%8C%EB%A0%88%EC%9D%B4%EC%96%B4UI)
  - [플레이어 UX](/docs/vpe-player#%ED%94%8C%EB%A0%88%EC%9D%B4%EC%96%B4UX)
  - [메타데이터](/docs/vpe-player#%EB%A9%94%ED%83%80%EB%8D%B0%EC%9D%B4%ED%84%B0)

### 재생 소스

재생 소스를 설정해 주십시오. 스크립트 코드를 직접 수정하여 옵션을 좀 더 세부적으로 설정하려면 [재생 소스](/docs/vpe-example-source)를 참고해 주십시오.

- **URL**: 재생할 콘텐츠 URL 입력
- **Poster**: 섬네일 URL 입력
- **CC**: 자막 파일 URL 입력
  - 두 개 언어의 자막을 제공할 수 있습니다.

### 재생 설정

재생 옵션을 설정해 주십시오. 스크립트 코드를 직접 수정하여 옵션을 좀 더 세부적으로 설정하려면 [재생 설정](/docs/vpe-example-play)을 참고해 주십시오.

- **자동재생**: 자동 재생 여부 선택
- **음소거**: 재생 시 음소거 상태로 재생 여부 선택
- **반복재생**: 반복 재생 여부 선택
- **배속**: UI로 제공할 배속 배율 선택, 모두 미선택 시 배속 배율 변경 불가능
- **초저지연 모드**: Low Latency HLS 사용 여부 선택
- **최초공개일**: 최초 공개 일시 설정

### 플레이어 UI

플레이어 UI 관련 옵션을 설정해 주십시오. 스크립트 코드를 직접 수정하여 옵션을 좀 더 세부적으로 설정하려면 [플레이어 UI](/docs/vpe-example-ui)를 참고해 주십시오.

- 플레이어 화면 비율에 관한 옵션을 설정해 주십시오.
  - **화면비**: 플레이어의 화면비 선택
  - **화면채움**: 재생 소스의 화면 채움 방식 선택
- 컨트롤바에 관한 옵션을 설정해 주십시오.
  - **컨트롤바**: 플레이어 컨트롤바 사용 여부 선택
  - **컨트롤 UI 유형**: 플레이어 컨트롤바 제공 UI 선택
  - **컨트롤바 컬러**: 컨트롤바 영상 탐색 슬라이더의 색상 설정
  - **컨트롤 자동숨김 시간**: 컨트롤바가 자동으로 숨겨지는 시간 선택
  - **언어설정**: 컨트롤바에 표시되는 언어 선택
  - **플레이 버튼**: 플레이 버튼 표시 여부 설정
  - **볼륨 조절**: 볼륨 조절 UI 표시 여부 설정
  - **시간표시**: 전체 영상 시간 및 현재 재생 시간 표시 여부 설정
  - **PIP**: PIP(Picture In Picture) 플레이어 모드 전환 버튼 표시 여부 설정
  - **풀스크린**: 전체 화면 전환 버튼 표시 여부 설정
  - **자막**: 자막 설정 버튼 표시 여부 설정
  - **설정**: 플레이어 설정 버튼 표시 여부 설정
- 커스텀 버튼에 관한 옵션을 설정하려면 먼저 **설정**의 토글 버튼을 클릭하여 **True**로 설정해 주십시오. 설정 옵션이 표시되면 다음 설정을 완료한 후 **[추가]** 버튼을 클릭해 주십시오.

              참고

              

커스텀 버튼의 정확한 추가 위치는 [커스텀 버튼 추가](/docs/vpe-example-ui#%EC%BB%A4%EC%8A%A4%ED%85%80%EB%B2%84%ED%8A%BC%EC%9C%84%EC%B9%98)에서 확인해 주십시오.
  - **버튼 이미지 URL**: 커스텀 버튼 이미지 URL 입력
  - **버튼 위치**: 커스텀 버튼이 추가될 영역 선택
  - **생성 위치**: 기존 버튼을 기준으로 커스텀 버튼 추가 위치 선택
  - **버튼 UI**: 커스텀 버튼을 적용할 디바이스 환경 선택

### 플레이어 UX

플레이어 UX 관련 옵션을 설정해 주십시오. 스크립트 코드를 직접 수정하여 옵션을 좀 더 세부적으로 설정하려면 [플레이어 UX](/docs/vpe-example-ux)를 참고해 주십시오.

- **음소거 알림창 표시**: 음소거 상태 표시 여부 선택
- **텍스트 워터 마크**: 텍스트 워터마크 표시 여부 선택
  - **사용**을 선택한 경우, 텍스트 워터마크의 랜덤 위치 사용 여부를 선택한 후 다음 옵션을 설정해 주십시오.
    - 랜던 위치 사용 시 텍스트 워터마크의 노출 위치 변경에 대한 시간값을 선택해 주십시오.
    - 랜덤 위치 미사용 시 텍스트 워터마크의 가로/세로 위치 값 및 투명도를 설정해 주십시오.
- **구간이동 미리보기**: 컨트롤바의 탐색 슬라이더 위에 미리 보기 섬네일 추가 여부 선택
- **브라우저 비활성 시 자동정지**: 브라우저 또는 웹뷰 비활성 시 자동 정지 여부 선택
- **터치 제스처**: 모바일 모드에서 터치를 이용한 구간 이동 기능 사용 여부 선택
- **키보드 단축키**: 키보드를 이용한 플레이어 컨트롤 기능 사용 여부 선택
- **IOS 웹 전체 화면 방식**:  iOS 모바일 사파리에 대응하는 Fullscreen 모드 선택

### 메타데이터

메타데이터를 설정해 주십시오. 스크립트 코드를 직접 수정하여 옵션을 좀 더 세부적으로 설정하려면 [메타데이터](/docs/vpe-example-metadata)를 참고해 주십시오.

- **디스크립션**: 플레이어 상단에 영상 제목, 업로더 정보 등 표시 여부 설정
- **제목**: 영상 제목 입력
- **업로드 날짜**: 영상 업로드 날짜 입력
- **프로필**: 프로필 입력
- **프로필 이미지**: 프로필 이미지 URL 입력

              참고

              

메타데이터 클릭 시 액션을 구현할 수 있는 Click 이벤트는 스크립트 코드로 직접 구현해 주십시오. 자세한 내용은 [메타데이터 Click 이벤트](/docs/vpe-example-metadata#%EB%A9%94%ED%83%80%EB%8D%B0%EC%9D%B4%ED%84%B0Click%EC%9D%B4%EB%B2%A4%ED%8A%B8)를 참고해 주십시오.

## DRM 테스트

재생 콘텐츠에 대한 DRM 적용 테스트를 진행할 수 있습니다.

              참고

              

- 스크립트 코드를 통해 DRM 테스트를 진행할 수도 있습니다. 자세한 내용은 [콘솔 DRM 테스트](/docs/vpe-example-auth#%EC%BD%98%EC%86%94DRM%ED%85%8C%EC%8A%A4%ED%8A%B8)를 참고해 주십시오.
- 콘솔에서 DRM 테스트를 진행할 경우, 콘솔 내 스크립트에 해당 내용이 반영되지 않습니다.

테스트 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Media** > **Video Player Enhancement** 메뉴를 차례대로 클릭해 주십시오.
2. **Video Player Management** 메뉴를 클릭해 주십시오.
3. 플레이어 목록에서 테스트를 진행할 플레이어의 **[옵션 설정]** 버튼을 클릭해 주십시오.
4. **[DRM 테스트]** 탭을 클릭해 주십시오.
5. 테스트 환경을 선택한 후 테스트할 콘텐츠 정보를 입력해 주십시오.
  - 브라우저 종류에 따라 테스트 환경을 선택해 주십시오.
    - **Widevine/PlayReady**: Chrome 또는 Windows OS Edge 브라우저에서 테스트 시 선택
    - **FairPlay**: Mac OS Safari 브라우저에서 테스트 시 선택
  - **Widevine/PlayReady** 선택 시 DASH 재생 소스 URL과 DRM 토큰 값을 차례대로 입력해 주십시오.
  - **FairPlay** 선택 시 HLS 재생 소스 URL, Certificate URL, DRM 토큰 값을 차례대로 입력해 주십시오.
6. **[Test Play]** 버튼을 클릭해 주십시오.

## 플레이어 복제

특정 플레이어를 복제하여 동일한 옵션을 가진 새로운 플레이어를 손쉽게 생성할 수 있습니다. 플레이어를 복제하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Media** > **Video Player Enhancement** 메뉴를 차례대로 클릭해 주십시오.
2. **Video Player Management** 메뉴를 클릭해 주십시오.
3. 플레이어 목록에서 복제할 플레이어를 클릭하여 선택한 후 **[복제하기]** 버튼을 클릭해 주십시오.
4. 비디오 플레이어 복제 팝업 창에서 복제하여 생성할 플레이어 정보를 설정한 후 **[생성하기]** 버튼을 클릭해 주십시오.
  - **플레이어 이름**: 콘솔에 표시할 플레이어 이름 입력
    - 영어로 시작해야 하며, 영문자, 숫자, 특수문자(_, -, @)를 조합하여 3~30자 이내로 입력해 주십시오.
  - **SDK 자동 업데이트**: SDK 자동 업데이트 기능 사용 여부 선택
  - **SDK 버전**: 사용할 SDK 버전 선택
  - 선택한 플레이어와 동일한 옵션의 플레이어가 생성되어 목록에 표시됩니다.

## 플레이어 배포

설정을 완료한 플레이어는 배포 목적에 따라 개발(Develop) 또는 리얼(Production) 환경에 배포할 수 있습니다. 또한, 개발 환경에 배포한 플레이어의 설정은 롤백할 수도 있습니다.

### Develop 배포

리얼 환경에 배포하기 전 테스트를 위해 개발 환경에 배포하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Media** > **Video Player Enhancement** 메뉴를 차례대로 클릭해 주십시오.
2. **Video Player Management** 메뉴를 클릭해 주십시오.
3. 플레이어 목록에서 개발 환경에 배포할 플레이어의 **[옵션설정]** 버튼을 클릭해 주십시오.
4. 배포할 플레이어를 미리 보기로 확인한 후 **[Develop 배포]** 버튼을 클릭해 주십시오.
  - 플레이어가 개발 환경으로 배포됩니다.

### Production 배포

실제 사용자들에게 서비스하기 위해 리얼 환경에 배포하는 방법은 다음과 같습니다.

              참고

              

- 개발 환경에 배포된 플레이어만 Production 배포를 할 수 있습니다. 자세한 내용은 [Develop 배포](/docs/vpe-player#Develop%EB%B0%B0%ED%8F%AC)를 참고해 주십시오.
- Production 배포는 가장 마지막으로 Develop 배포한 플레이어를 리얼 환경으로 배포합니다. 따라서 변경된 사항을 리얼 환경에 적용하려면 옵션을 변경한 후 반드시 Develop 배포를 먼저 진행해 주십시오. Develop 배포를 하지 않고 Production 배포를 할 경우, 변경한 옵션이 리얼 환경에 적용되지 않습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Media** > **Video Player Enhancement** 메뉴를 차례대로 클릭해 주십시오.
2. **Video Player Management** 메뉴를 클릭해 주십시오.
3. 플레이어 목록에서 리얼 환경에 배포할 플레이어의 **[옵션설정]** 버튼을 클릭해 주십시오.
4. 배포할 플레이어를 미리 보기로 확인한 후 **[Production 배포]** 버튼을 클릭해 주십시오.
5. Production 배포 팝업 창의 **[확인]** 버튼을 클릭해 주십시오.
  - 개발 환경에 배포된 옵션과 동일하게 리얼 환경으로 배포됩니다.

### Develop 롤백

Develop 배포한 설정을 롤백하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Media** > **Video Player Enhancement** 메뉴를 차례대로 클릭해 주십시오.
2. **Video Player Management** 메뉴를 클릭해 주십시오.
3. 플레이어 목록에서 롤백할 플레이어의 **[옵션설정]** 버튼을 클릭해 주십시오.
4. **[Develop 롤백]** 버튼을 클릭해 주십시오.
5. Develop 롤백 팝업 창의 내용을 확인한 후 **[확인]** 버튼을 클릭해 주십시오.
  - Develop 배포된 플레이어 설정이 롤백되어 리얼 환경과 동일한 설정으로 변경됩니다.

## 플레이어 삭제

플레이어를 삭제하는 방법은 다음과 같습니다.

              참고

              

Media Analytics 서비스와 연동된 플레이어를 삭제할 경우, 플레이어 연동 목록에서도 자동으로 삭제됩니다.

1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Media** > **Video Player Enhancement** 메뉴를 차례대로 클릭해 주십시오.
2. **Video Player Management** 메뉴를 클릭해 주십시오.
3. 플레이어 목록에서 삭제할 플레이어를 클릭하여 선택한 후 **[삭제하기]** 버튼을 클릭해 주십시오.
4. 삭제하기 팝업 창의 내용을 확인한 후 **[삭제]** 버튼을 클릭해 주십시오.
  - 플레이어가 삭제되어 플레이어 목록에서 사라집니다.

## SDK 주소 확인 및 다운로드

Native 플레이어를 개발하기 위해 SDK 주소를 확인하거나 SDK를 다운로드하는 방법은 다음과 같습니다.

              참고

              

Basic 요금제의 경우 SDK를 다운로드할 수 없습니다. SDK를 다운로드하려면 [Standard 요금제로 전환](/docs/vpe-start#%EC%9C%A0%EB%A3%8C%EC%9A%94%EA%B8%88%EC%A0%9C%EC%A0%84%ED%99%98)해 주십시오.

1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Media** > **Video Player Enhancement** 메뉴를 차례대로 클릭해 주십시오.
2. **Video Player Management** 메뉴를 클릭해 주십시오.
3. 플레이어 목록에서 SDK 주소를 확인하거나 SDK를 다운로드할 플레이어의 **[SDK 주소]** 버튼을 클릭해 주십시오.
4. SDK 주소를 확인하려면 확인할 SDK 주소의 서비스 환경을 선택해 주십시오.
  - 선택한 서비스 환경의 SDK 주소를 **SDK 주소**에서 확인할 수 있으며, **[복사]** 버튼을 클릭하여 SDK 주소를 클립보드에 복사할 수 있습니다.
5. SDK를 다운로드하려면 디바이스에 따라 **[IOS]** 버튼 또는 **[Android]** 버튼을 클릭해 주십시오.