---
title: "일반적인 문제"
slug: "vpe-troubleshoot-common"
updated: 2026-08-20T09:03:39Z
published: 2026-08-20T09:03:39Z
canonical: "guide-gov.ncloud-docs.com/vpe-troubleshoot-common"
---

> ## 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.

# 일반적인 문제

<p class="platform-info type-classic-vpc">Classic/VPC 환경에서 이용 가능합니다.</p>
 


Video Player Enhancement 서비스를 이용하면서 다음과 같은 문제를 겪을 수 있습니다. 문제별 원인과 해결 방법을 확인하고 적절하게 조치해 주십시오. 
 
## "라이선스가 유효하지 않습니다." 오류 메시지 <a name="라이선스가유효하지않습니다오류메시지"></a>
영상 재생 시 "라이선스가 유효하지 않습니다." 오류 메시지가 표시되고 영상이 실행되지 않습니다. 
오류 코드 E0005가 표시됩니다. 

#### 원인  
도메인 검증을 위해 사이트 도메인 설정 영역에 사이트 도메인 주소를 입력하게 되는데, 도메인이 일치하지 않을 경우 라이선스 오류가 발생합니다. 
   
#### 해결 방법
등록한 도메인과 일치하는지 확인 부탁드립니다.  


## 도메인 등록 시 라이선스 오류  <a name="도메인등록시라이선스오류"></a>
사이트 도메인을 *.a.com 형태로 등록할 경우, 플레이어 라이선스 오류가 발생합니다. 

#### 원인  
현재 사이트 도메인 등록 시 와일드카드 형식은 지원하지 않습니다.

#### 해결 방법
와일드카드 형식은 지원하지 않으므로, 모든 사이트를 전부 등록해 주십시오. 


## 영상 컨트롤바 누락 <a name="영상컨트롤바누락"></a>
모바일에서 영상에 컨트롤바가 나타나지 않습니다.   

#### 원인  
플레이어를 설치한 HTML의 다른 요소 혹은 CSS 영향으로 컨트롤바가 노출되지 않을 수 있습니다.

#### 해결 방법
HTML에 플레이어만 설치한 후 테스트해 주십시오. 문제가 없다면 HTML에서 사용되고 있는 CSS 요소가 충돌되지 않는지 점검해 주십시오. 

## 전체보기 버튼 누락 <a name="전체보기버튼누락"></a>
모바일에서 영상의 **[전체보기]** 버튼이 나타나지 않습니다. 

#### 원인  
콘솔에서 **[전체보기]** 버튼이 비활성화되도록 설정되어 있을 경우, 해당 버튼이 나타나지 않습니다. 

#### 해결 방법

**[전체보기]** 버튼을 활성화하는 방법은 다음과 같습니다. 
1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Media** > **Video Player Enhancement** > **Video Player Management** 메뉴를 차례대로 클릭해 주십시오.
2. **옵션설정** 버튼을 클릭해 주십시오. 
3. **[플레이어 UI]** 탭에서 **컨트롤바 버튼 설정** > **풀스크린** 항목을 활성화해 주십시오.
4. **[확인]** 버튼을 클릭해 주십시오. 
    * 자세한 내용은 [컨트롤바 버튼 UI](/docs/vpe-example-ui#컨트롤바버튼UI)를 참조해 주십시오. 


강제로 옵션 UI를 설정하는 방법은 다음과 같습니다. 
```
-uilet player = new ncplayer('video',{
new ncplayer('video1', {
  playlist: [
    {
      file: "{URL}",
      poster: "{path"",
    },
  ],
  autostart: false,
  controlBtn: { // controlBtn 옵션은 유료만 사용가능
      play: true, // 재생
      fullscreen: true, // 전체 화면 전환
      volume: true, // 볼륨 컨트롤
      times: true, // 재생 시간
      pictureInPicture: true, // PIP
      setting: true, // 설정
  },
});
```

## iOS 웹 브라우저 오류 <a name="iOS웹브라우저오류"></a>

* iOS 웹 브라우저에서 토큰 기능이 동작하지 않습니다. 
* iOS 웹 브라우저에서 **[전체 화면]** 버튼을 클릭할 경우, "TypeError: undefined is not an object (evaluating 'this.video_player.textTracks[t].mode="showing"')" 오류 메시지가 표시됩니다.

#### 원인  
* 아이폰 시뮬레이터에서는 해당 기능이 동작하지 않습니다.
* 지원하는 버전이 아닙니다. 

#### 해결 방법
* Player SDK 버전을 1.1.2 이상을 사용해 주십시오.
* 자동 업데이트(/ncplayer.js)를 사용하도록 설정한 후, 캐시를 삭제해 주십시오. 


:::(Info) (참고)
이 가이드에서 필요한 정보를 찾지 못했거나 추가로 필요한 정보가 있으신 경우, 언제든지 아래의 피드백 아이콘을 클릭하여 의견을 보내 주십시오. 전달해 주신 의견을 참고하여 더 유용한 정보를 제공하겠습니다.
:::