【Godot Engine 4】MetaQuest2/QuestProで動作するVRアプリを作る
はじめに
Godot EngineでVRアプリを作ってみたかったので、とりあえずビルドして実機でアプリを動かすまで試してみました。
初めてのGodotEngine開発なので間違っている箇所や至らない点があるかと思います。
何かありましたらコメントやX(Twitter)などでご連絡いただけると嬉しいです。
QuestProでの動作デモ
開発環境
- OS: Windows10
- Godot Engine: 4.0 (https://downloads.tuxfamily.org/godotengine/)
(Godot Engine 4.1.1 (https://godotengine.org/) でも動作確認済み) - godot-xr-template 4.0.0 for Godot4.0 (https://github.com/GodotVR/godot-xr-template)
- Android SDK: 32
- JAVA: OpenJDK11 (https://jdk.java.net/archive/)
環境構築
Godot Engineのインストール
今回はGodot Engine 4.0 (2023-Mar-01) を使用しました。
公式サイトのダウンロードアーカイブからダウンロードできます。
GodotEngine v4.1.1(最新安定バージョン)でも動作しました。こちらの方が良いと思います。
ダウンロードはこちらから:https://godotengine.org/
2023年9月20日追記
GodotEngine には通常版とC#をサポートしている.NET版があります。現状(2023年9月16日現在)では、GodotEngine 4系の .NET版では Android ビルドができないため、今回は通常版を使用しました。
godot-xr-template のダウンロード
godot-xr-template は Godot Engine でVRアプリを作るためのテンプレートです。
VR用の設定がされているので、これを使用するとVRアプリを作るときに便利です。
今回は godot-xr-template 4.0.0 for Godot4.0 を使用しました。
godot-xr-template 4.0.0 for Godot4.0 では下記が含まれています。
- Godot XR Tools v4.1.0
- OpenXR Loaders v1.0.0
JAVA11 の設定
Android ビルドに JAVA11 が必要です。今回は OpenJDK を使用しました。
- OpenJDK のダウンロード
https://jdk.java.net/archive/ から 11.0.2 (build 11.0.2+9) をダウンロード - 環境変数 JAVA_HOME に JDK ディレクトリ を追加
- PATH に %JAVA_HOME%/bin を追加
Godot Engine 上でのビルド設定
GodotEngine で godot-xr-template プロジェクトを開く
Androidビルドテンプレートのインストール
- プロジェクト設定 > Androidビルドテンプレートをインストール
- 確認画面 から テンプレートの確認へ
- エクスポートテンプレートマネージャー > ダウンロードしてインストール
- プロジェクト設定 > Androidビルドテンプレートを開くと確認画面が開く > インストール
その他設定
- エクスポートの設定 > MetaQuest プリセット を選択 > 署名付き > チェックを外す
- debug.keystore のパスを指定する : エディタ設定 > Export > Android > Debug Keystore > パスを指定 (自分の環境では C:/Users/[UserName]/.android/debug.keystore )
- (debug.keystore がない場合は作る→ https://docs.godotengine.org/en/stable/tutorials/export/exporting_for_android.html )
ビルド
- Export > MetaQuest(Runnable)を選択 > Export Project でビルド開始
- 生成された apk を MetaQuest2/QuestPro にインストール(adb install / MetaQuestDeveloperHub など)
Export画面で Export All を実行するとプリセットにある全てのプラットフォームに対してビルドが行われます
ビルド設定が正しく、かつ、MetaQuest2/QuestProをPCに接続していれば、Remote Debug が使用できます。
Remote Debug を実行すると接続している実機にapkがインストールされてテストすることができます
画面がちらつく場合の対処
現象
対処
Project設定 > 表示(Display) > ウインドウ > 垂直同期 > V-Sync Mode > Disabled
おわりに
X(Twitter) で「GodotEngine触ってみる」というスペースを開きながらした作業を今回の記事に整理してまとめています。下記スレッドに一連の(紆余曲折した)投稿がまとまっています。興味ある方はこちらもどうぞ。
参考
GodotEngine: https://godotengine.org/
- Setting up XR : https://docs.godotengine.org/en/latest/tutorials/xr/setting_up_xr.html
- Exporting for Android : https://docs.godotengine.org/en/stable/tutorials/export/exporting_for_android.html
FRAME SYNTHESIS : https://framesynthesis.co.jp/
- Godot4 VR開発メモ : https://tech.framesynthesis.co.jp/godot/vr/
Discussion