---
title: "一般的な問題"
slug: "vpe-troubleshoot-common"
updated: 2026-09-17T09:22:05Z
published: 2026-09-17T09:22:05Z
canonical: "guide.ncloud-docs.com/vpe-troubleshoot-common"
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 Enhancementサービスの利用中に次のような問題が発生することがあります。問題ごとの原因と解決方法を確認し、適切に対処してください。

## 「ライセンスが無効です。」というエラーメッセージ

動画再生時に「ライセンスが無効です。」というエラーメッセージが表示され、動画が実行されません。 エラーコード E0005が表示されます。

#### 原因

ドメイン検証のため、サイトドメイン設定領域にサイトドメインのアドレスを入力しますが、ドメインが一致しない場合にライセンスエラーが発生します。

#### 解決方法

登録したドメインと一致しているかご確認ください。

## ドメイン登録時のライセンスエラー

サイトドメインを*.a.comの形式で登録する場合、プレイヤーライセンスエラーが発生します。

#### 原因

現在、サイトドメイン登録時にワイルドカード形式には対応していません。

#### 解決方法

ワイルドカード形式には対応しておりませんので、すべてのサイトを登録してください。

## 動画のコントロールバーが表示されない

モバイルで動画にコントロールバーが表示されません。

#### 原因

プレイヤーをインストールした HTMLの他の要素や CSSの影響でコントロールバーが表示されない場合があります。

#### 解決方法

HTMLにプレイヤーのみインストールしてテストしてください。問題がない場合、HTMLで使用されている CSS要素が競合していないかご確認ください。

## すべて表示ボタンが表示されない

モバイルで動画に **[すべて表示]** ボタンが表示されません。

#### 原因

コンソールで **[すべて表示]** ボタンが無効に設定されている場合、当該ボタンは表示されません。

#### 解決方法

**[すべて表示]** ボタンを有効にする方法は、次の通りです。

1. NAVERクラウドプラットフォームコンソールで、 **Menu** > **All Services** > **Video Player Enhancement** >  **Video Player Management** メニューを順にクリックします。
2. **オプション設定** ボタンをクリックします。
3. **[プレイヤー UI]** タブで**コントロールバーボタン設定** > **フルスクリーン** 項目を有効にします。
4. **[確認]** ボタンをクリックします。

- 詳細は、[コントロールバーボタン UI](/docs/ja/vpe-example-ui#%EC%BB%A8%ED%8A%B8%EB%A1%A4%EB%B0%94%EB%B2%84%ED%8A%BCUI)をご参照ください。

強制的にオプション 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ウェブブラウザエラー

- iOSウェブブラウザでトークン機能が動作しません。
- iOSウェブブラウザで **[フルスクリーン]** ボタンをクリックすると、「TypeError: undefined is not an object (evaluating 'this.video_player.textTracks[t].mode="showing"')」というエラーメッセージが表示されます。

#### 原因

- iPhoneシミュレータでは、当該機能は動作しません。
- サポートするバージョンではありません。

#### 解決方法

- Player SDKのバージョンは1.1.2以降を使用してください。
- 自動アップデート(/ncplayer.js)を有効にした後、キャッシュを削除してください。

              参考

              

本ガイドで必要な情報が見つからない場合やさらに必要な情報がある場合は、いつでも以下のフィードバックアイコンをクリックして、ご意見をお寄せください。いただいたご意見を参照して、より有益な情報を提供できるよう努力してまいります。