この記事は BasisVR Advent Calendar 2026 の記事です。
先日開催された大学祭の展示向けに、Meta Quest 2 スタンドアロンで動く VR 音楽ゲームを BasisVR ベースで作って運用しました。
私は以前にも BasisVRとは何なのか? という記事を書きましたが、今回はその Basis を使って展示用のアプリを作り、大学祭の本番で運用してみた記録です。
作ったもの
今回作ったのは、モノクロの空間に浮かぶ 5×5 の枠をハンドトラッキングの指先で触れて遊ぶ VR 音楽ゲームです。
- Meta Quest 2 のスタンドアロンで動作
- ハンドトラッキング対応
- サークル作の触覚グローブ(Raspberry Pi Zero W 搭載)と BLE で直接接続
- 自作の整理券システムと HTTP / WebSocket で連携
実装としては Basis のネットワーク機能を使ったマルチプレイ観戦の仕組みも用意したのですが、今回の展示本番では使わず、1 人用のスタンドアロン構成で運用しました。触覚グローブや整理券システムが繋がらない状態でも、単体のゲームとしてそのまま遊べるようになっています。
なぜBasisを使ったのか
私は昨年も大学祭向けに、VRChat の Contacts と OSC を使った触覚グローブの展示を行いました。ただ、このときは VRChat から出力される OSC(OSCQuery)をローカルネットワーク経由で Raspberry Pi へ転送する必要があり、通信周りでかなり悩みました。
今年はそこを解消したかったのと、展示の運用で使う仕組みをそのままアプリに組み込みたかったため、Basis を使うことにしました。Unity でゼロから作るのとは違い、アバターの読み込みや IK、OpenXR のハンドトラッキング、AudioLink といった VR の基盤をそのまま借りつつ、クライアント本体を自由に書き換えられるのが大きかったです1。
今回の展示では、特に外部連携を自由に組めた点が大きかったです。触覚グローブでは Android の BluetoothGatt を呼ぶコードを組み込み、Quest 2 から Raspberry Pi Zero W へ片方向の BLE で振動データを直接送るようにしました。昨年の OSC 構成のように会場の Wi-Fi やローカル IP の解決に悩む場面がなくなり、去年に比べてネットワークで困ることがなかったのは本当に良かったです。
自作の整理券システムとの連携もアプリ側で HTTP ポーリングと WebSocket を直接扱う形で実装しました。スタッフが手元のスマートフォンから体験を開始すると、アプリ側で自動的にステージの向きを合わせてチュートリアルが始まるようにしています。また、体験中にポーズやリスタート、曲選択への復帰などをスタッフのスマートフォン側からコマンドで操作できるようにしたため、来場者が操作に迷ったときもヘッドセットを外さずにこちらから状態を戻せて便利でした。
加えて、楽曲や譜面、UI、アバターなどをすべてアプリ内に同梱してビルドできたので、会場の通信環境を気にせず Quest 2 単体で完結させられたのも展示用途としては安心感がありました。
もう一つ、Basisを使っていて良かったのが開発者との距離の近さです。開発途中で IK やハンドトラッキングの挙動に困ったとき、コミュニティでその話をしたら数日以内にハンドトラッキングに関する修正が入り、とてもありがたかったです。後で書く「使わない機能をオフにしたい」という話についても、コアコントリビューターの dooly 氏から「そのあたりは現在積極的に取り組んでいます。」という反応をもらえました。まだ発展途上の部分はあるものの、開発側と直接やり取りしながら進められるのはオープンソースならではの良さだと思います。
手を入れる必要があったところ・困ったところ
一番手間がかかったのは、使わない機能をオフにしてビルドから外すところでした。今回の音楽ゲームでは Basis 標準のメニュー画面やローディングバー、リップシンク(OpenLipSync)、Web カメラ追跡(MediaPipe)、多言語テーブルなどは使わないため、これらを止めたいと考えました。
ただ、シーンから関連オブジェクトを消しただけではビルドから削られてくれませんでした。Basis/Assets/Basis/link.xml で全アセンブリに preserve="all" が書かれていてコードが削られないほか、Addressables のグループも IncludeInBuild が有効になっていると参照が無くてもそのままビルドに含まれてしまうためです。また、BasisOpenLipSyncDriver の初期化処理がメインスレッドで WaitForCompletion() の完了を待つ箇所もありました。
かといって Basis 本体のコードを直接消していくと後で戻すのもアップストリームに追従するのも大変になるので、今回はコードを消さずに実行時のフラグで切り替える BasisFootprint というアセットと、シーン読み込み前にフラグを適用する BasisFootprintBootstrap を自分で用意しました。
[RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.BeforeSceneLoad)]
private static void Apply()
{
BasisFootprint footprint = Resources.Load<BasisFootprint>(BasisFootprint.ResourceName);
// ...
BasisMainMenu.MenuSuppressed = !footprint.MainMenu;
BasisUILoadingBar.SetDisplaySuppressed(!footprint.LoadingBar);
BasisOpenLipSyncDriver.Enabled = footprint.LipSync;
BasisLocalization.Enabled = footprint.Localization;
BasisBuildPolicy.BootsIntoVR = footprint.VROnly;
}
このようにフラグを見て早期リターンする最小限のガードをいくつか差し込み、Addressables 側でも使わない 4 グループ(MediaPipe のモデルや言語テーブル、OpenLipSync のモデルなど約 80 MB 分)の IncludeInBuild をオフにして対処しました。この点は dooly 氏も現在積極的に取り組んでいるとのことだったので、今後は標準側で切り離しやすくなっていくのだと思います。
さいごに
本番は Quest 2 スタンドアロンに触覚グローブと整理券システムを繋いで運用しましたが、アプリについては特にトラブルなくそのまま進められました。
今回の用途のようにオフライン環境で単体動作する展示アプリを作るという使い方だと、VRChatなど既存のシステムを使うのに比べて非常にやりやすさを感じました。開発者と近い距離でやり取りしながら進められる点も含めて、Basis を使って良かったと感じています。
-
Basis で UGC(ユーザー生成コンテンツ)としてスクリプトを動かす場合は Cilbox というサンドボックス環境を通りますが、クライアント本体側に直接パッケージを組み込めば通常の Unity / C# としてそのまま書けます。 ↩
