TOP › マイページTOP ›
入稿ドキュメントMAP › Vket公式アセット ›
VketVideoPlayer

VketVideoPlayer

概要

動画プレイヤーのPrefabです。

再生ボタンを押すか、来場者が各出展者の展示スペースに入ったタイミング、または展示スペース内の指定したエリアに入ったタイミングで動画が再生されるように設定できます。

Vket 2026 Winterから仕組みが変わりました。動画プレイヤー本体（VketVideoCore）はワールドに1つだけ配置され、各出展物に配置した VketVideoController から本体に再生を依頼して、出展物ごとに切り替えて使われます。

動画の再生状況はほかの来場者と同期されません(ローカル再生)。また、スペースから離れた時点で再生は停止します。

設置数制限: VketVideoPlayerは1スペースにつき1つのみ使用可能です。

動画はURLで指定します。任意の動画ファイルを入稿して指定することはできません。

設定方法

※本ページの手順は入稿用シーンを開いている状態からの開始を想定しています。
※入稿用シーンの作成方法はこちら(Vket 2026 Winter入稿ガイド)

VketPrefabMainMenuの呼び出し方

Unity上部メニューの VketTools から Show Control Panel をクリックし、VketToolsを開きます。
※VketToolsウィンドウで VRChat SDKにログインしてください と表示された場合は、「VRChat SDK」ウィンドウからVRChatアカウントにログイン後、再度お試しください。
VketToolsの下部にある VketPrefabs一覧 ボタンをクリックします。
VketPrefabMainMenuウィンドウ内を下にスクロールして 名前:VketVideoPlayer と書いてある項目の 生成と設定 ボタンをクリックします。

設定ウィンドウ（Vket Video Controller）の解説

設定ウィンドウが開いたら、上から順に各項目を設定していきます。

設定ウィンドウを途中で閉じてしまった場合でも、Hierarchyに追加された VketVideoPlayer を選択して、Inspectorの Open Setting Window から各種設定の変更が可能です。

設定ウィンドウ

※VRChatの仕様により、YouTube等の許可されたサイト以外にアップロードされた動画は標準では再生されません(来場者側で「信頼されていないURLを許可」の設定を変更できます)。YouTube等の許可されたURLを入力してください。許可されていないURLを入力すると、入力欄の下に警告が表示されます。
※許可されたサイトの一覧はこちら。
※URLが http:// で始まる場合、Androidでは再生されません。https:// のURLを入力してください。

2.再生方法の設定

Loop
動画をループ再生します。初期状態では有効になっています。
Use AVPro
AVProVideoPlayer方式で再生します。初期状態では有効になっています。
※Unityエディタ上ではAVProが動作しないため、常にUnityVideoで再生されます。
Auto Play Mode
自動再生の条件を選択します。
- OnBoothEnter：来場者が展示スペースに入ったときに自動再生します（初期状態）。
- OnAreaEnter：来場者の頭が指定した判定エリアに入ったときに自動再生します。
- Disabled：自動再生しません。再生ボタンからのみ再生します。

OnAreaEnter を選択した場合は、設定ウィンドウ下部の 判定エリアを追加 ボタンをクリックしてください。VketVideoPlayer の子にTriggerのBoxColliderが作成され、判定エリアに追加されます。BoxColliderの範囲はInspectorから調整してください。

判定エリアを追加

判定エリアのBoxCollider

※判定エリアにMeshColliderを使う場合は、Convexを有効にしてください。凸でないMeshColliderでは正確に判定できません。

3.スクリーンの設定

動画を表示する Screen が設定されていることを確認します。Screenが設定されていないとビルドが失敗します。

※Screenのマテリアルは、ビルド時に動画用のマテリアルへ置き換わります。

スクリーンサイズの調整 では、アスペクト比、幅 (m)、高さ (m) を再生させたい動画に合わせて調整してください。スクリーンの大きさに合わせて、操作パネルの大きさと位置も調整されます。

スクリーンの設定

4.待機画像と読込画像

Standby Image：動画が再生されていないときに表示する画像です。
Loading Image：動画のロード中に表示する画像です。

画像は選択欄右端のボタンから選択するか、Projectウィンドウから画像ファイルを選択欄にドラッグ&ドロップして設定します。

5.音声の設定

Default Volume
初期状態の音量を0〜1の範囲で設定します。
Bgm Fade Mode
動画の再生中にワールドBGMを下げる条件を選択します。
- WhilePlaying：動画の再生中は常にワールドBGMを下げます（初期状態）。
- WhilePlayingAndNear：動画の再生中、かつ来場者の頭がAudioSourceの Max Distance の範囲内にあるときだけワールドBGMを下げます。
- Disabled：ワールドBGMを下げません。