【Unity】【Oculus】UnityでOculus Quest向けのアプリをビルドして実行するまでの手順まとめ

UnityでOculus Quest向けのアプリをビルドして実行するまでの手順をまとめました。

Unity2019.2.6
SideQuest 0.7.4

はじめに

この記事ではOculus Questの開発をUnityで行うための手順をまとめます。
前提として、Oculus Questのペアリング・初期設定は完了しているものとします。

ドキュメントとしてはUnity公式がリンクを作っているため、まずここを見るのがよさそうです。

unity3d.com

またここからOculus公式のドキュメントにもリンクされています。
開発を進める上ではここを中心に見ていくことになりそうです。

developer.oculus.com

開発者登録をしてOculus Questを開発者モードにする

さて、Oculus Questの開発を行うには開発者登録(といってもひとまずは適当な組織名を登録するだけ)をする必要があります。
もしストアにそのまま公開する場合にはこの名前が使われます。
開発者登録をするにはまず下記のページにアクセスします。

dashboard.oculus.com

すると下図のようなページが出てくるので組織名を入力して画面の案内に沿って進めます。

f:id:halya_11:20191022235511p:plain:w500

開発者登録が終わったら、Oculus Questを開発者モードにします。
開発者モードにするにはOculusのアプリの設定画面からその他の設定を選択します。

f:id:halya_11:20191023001630p:plain:w250

次に開発者モードを選択します。

f:id:halya_11:20191023001654p:plain:w250

あとは開発者モードのトグルをONにするだけです。

f:id:halya_11:20191023001735p:plain:w250

UnityでAndroidビルド用の設定を行う

次にUnityでビルド設定を行います。
OculusはAndroid OSで動作しているためAndroidビルド設定を行います。

UnityでAndroid Build Supportをインストールしていない場合はインストールし、
Android SDKJDK、NDKがセットアップされていない場合には設定します。
この辺りはOculusというよりUnityの一般的な設定になり、情報が十分に出回っているので省略します。

次にAndroidにSwitch PlatformしてPlayer Settingsを開きます。
まずXR SettingsからVirtual Reality SupportedをONにしてVirtual Reality SDKsにOculusを追加します。

f:id:halya_11:20191023005933p:plain:w450

すると上図のようにGraphics APIからVulkanを抜くように警告されます。
Other SettingsのGraphics APIsからVulkanを削除します。

f:id:halya_11:20191023010043p:plain:w450

次にCompanyNameとProductNameを入力します。
初期設定のままではビルドできないので適当に変えておきます。

f:id:halya_11:20191023225512p:plain:w450

最後にOther SettingsからMinimum SDK Versionを19以上に設定しておきます。

f:id:halya_11:20191023225632p:plain:w450

ちなみにもし19未満のままビルドした場合、以下のようなエラーが出ます。

f:id:halya_11:20191023225529p:plain:w450

ここまで設定出来たらあとはシーンを追加してapkをビルドするだけです。

f:id:halya_11:20191023235934p:plain:w450

SideQuestでインストール

さて次に出力したapkをOculus Questにインストールします。
SideQuestというツールを使う方法が簡単そうなので、今回はこの方法で行います。

まずgithubのリリースページからSideQuestをダウンロード、インストールします。

github.com

WindowsであればSideQuest-Setup-0.7.4-x64-win.exeをダウンロードすればよさそうです。
インストールが終わるとこんな画面が出てきます。

f:id:halya_11:20191023230139p:plain

最初の一回はOculusを被って、USBデバッグを許可する必要がありました。
許可すると上図のように左上に緑色の〇が表示されてConnected状態となります。

アプリをインストールするには、まず左下のメニューからMy Appsを選択します。
次に上部の「Drag and drop your APK/OBB files」と書いてあるところにapkをドラッグ&ドロップします。

f:id:halya_11:20191024000448p:plain

以上でインストール完了です。

Oculus Questで実行する

インストールが完了したらOculus Questでアプリを実行します。
この方法でインストールしたアプリはライブラリの提供元不明のアプリの中に含まれています。

f:id:halya_11:20191024001023j:plain

あとはこれを実行して、正常にシーンが表示されればOKです。

参考

UnityのOculusのGetting Startedページ
unity3d.com

開発者登録と開発者モードの設定方法
developer.oculus.com

Androidビルド用の設定
developer.oculus.com

Side Questの手順はこちらを参考にさせていただきました
vr-maniacs.com