HaLake Magazine

コワーキングスペースHaLakeの技術情報発信サイト!IoT,AR,VRなど最新技術情報をお届け!

【図解】OculusQuest開発環境を整える導入編(2019/12月版)

f:id:takumishinoda:20191222155533j:plain 今回は初心者でも簡単にOculusQuestを開発する環境を整えていきます。
OculusQuestはAndroidを内蔵していて、Unityで開発が可能なので図解で設定や必須パッケージ等を説明していきます。

筆者環境

・MacBookPro(2017年モデル)
・Unity バージョン2019.2.17f1


前提条件

・UnityHubをインストールしている
・Unity(本記事では"2019.2.17f1"を使用)をインストールしている
・OculusQuestを開発者モードにしてある


前提条件解決参考

UnityHub・Unityのインストール
開発者モードについて


目次

  1. プロジェクトを作る
  2. 各種設定
  3. アセットの入手
  4. アセットをプロジェクトに適用
  5. 実機で動かす
  6. 終わりに


1. プロジェクトを作る

UnityHubを起動したらまずプロジェクトを作成します。
今回OculusQuestがAndroidを搭載しているので、先にJDK・AndroidSDKのインストールをしてからプロジェクトを作成します。

まず、プロジェクトを作成するUnityバージョンのメニューを開いて「モジュールを加える」をクリックします。

f:id:takumishinoda:20191222141722p:plain
図1: JDK・AndroidSDKインストール①

次に、「Android Build Support」下の項目全てにチェックをつけます。

f:id:takumishinoda:20191222141859p:plain
図2: JDK・AndroidSDKインストール②

これでUnityでAndroidアプリの開発ができるようになりました。


2. 各種設定

次にプロジェクトの環境設定をしていきますが、Unityの設定UIの文字が小さいので図でわかりやすく説明していきます。 主な設定はAndroidVR(Oculus)用の二つですが少々ボリュームがあるので間違えないよう気をつけましょう。

まずそれぞれの設定をするために「Build Settings」を開いていきます。
「Build Settings」はFile>Build Settingsで開くことができます。

f:id:takumishinoda:20191222142533p:plain
図3. Build Settingの出し方

「Build Settings」が開けると、下の図4のようになるかと思われます。
ここでまずこのプロジェクトがAndroidプリプロジェクトであることを下の図4にしたがって設定します。
もし既にこの設定ができていれば、Platfrom欄のAndroidの横にUnityマークがつきます。
おそらくこの設定には5分ほど時間がかかるかと思われるので焦らずに待ちましょう。

f:id:takumishinoda:20191222142733p:plain
図4. プラットフォームの変更

Androidプロジェクトに設定できたら次は「Player Settings」で設定していきます。
「Player Settings」は「Build Settings」の左端のボタンを押して開きます。

f:id:takumishinoda:20191222142812p:plain
図5. Player Settingの出し方

「Player Settings」が開けると右側に設定一覧があるので、まず「XR Settings」を開きます。
下の図6を参考にVRサポートの設定をしていきます。

f:id:takumishinoda:20191222142843p:plain
図6. VRサポート設定

これでこのプロジェクトがVRプロジェクトであることが設定できました。
しかし、ここで見落としがちな落とし穴として下の図7のような警告があります。
内容は、「Vulkan」というグラフィックAPIがXRに対応していないという内容です。
ここではあくまで警告として表示されていますが、ビルドするときにエラーが出てしまうのでこれを無効にする設定をしていきます。

f:id:takumishinoda:20191222143130p:plain
図7. ちょっとした落とし穴

「Vulkan」グラフィックAPIを無効にするには、「XR Settings」の少し上にある「Other Settings」で設定します。
「Other Settings」を開くと下の図8のようになるので、図8を参考に設定します。

f:id:takumishinoda:20191222143633p:plain
図8. Vulkanの無効化

次に、Androidアプリとしての設定をしていきます。
項目は、Androidアプリパッケージ名の形式でパッケージ名の設定とAndroidAPIレベルの設定です。
パッケージ名は好きに決めても良いですが、APIレベルは図9で指定されたものを設定してください。

f:id:takumishinoda:20191222143702p:plain
図9. Android用設定

設定はこれで終わりです。


3. アセット入手

これでプロジェクトがAndroidとOculus開発環境に設定できたので、Oculus開発アセットを適用します。
アセット名はOculus IntegrationでUnityAssetStoreからダウンロード・インポートできます。

UnityAssetStorewo開くにはUnity画面中央部のビューのメニューの「Asset Store」をクリックします。
アセットストアが開いたら検索欄でOculus Integrationを検索をしてアセットページを開きます。

f:id:takumishinoda:20191222150718p:plain
図10. アセットストアの出し方

Oculus Integrationのページが開いたらDownloadボタンを押してダウンロードをします。
ダウンロードが終わるとDownloadと書かれていたボタンが図12の様にImportに変わるので再度クリックします。

f:id:takumishinoda:20191222150754p:plain
図11. アセットのダウンロード
f:id:takumishinoda:20191222150838p:plain
図12. アセットのインポート

Importを押すと図14の様なウィンドウが出てくるので、右下のImportボタンをクリックしましょう。
すると、アセットのインポートが始まるので終了を待ちます。
このインポートも少し時間が掛かるので気長に待ちましょう。

f:id:takumishinoda:20191222151940p:plain
図13. インポート画面

インポートが終わると下の図13の様なアラートが出るかもしれません。
このアラートはパッケージ等のアップグレードを要求していますので、もしこの様なアラートが出たら指示に従ってアップグレードしていきましょう。
アップグレードが終わると再起動を要求されるのでUnityを再起動します。

f:id:takumishinoda:20191222150927p:plain
図14. パッケージのアップデート喚起アラート

ここまでの作業がうまくいくと下の図15の様にAssetsフォルダ直下にOculusフォルダが生成されます。
この中にOculusを開発するためのプレハブなどが格納されています。

f:id:takumishinoda:20191222152228p:plain
図15. アセットがインポートされた!

これで開発するための材料が揃いました。


4. アセットをプロジェクトに適用

アセットのインポートができたらこれで自由に開発ができるようになりました。
まずはVR内で自分の視点となるカメラを配置していきます。

VR視点カメラのプレハブは、Assets/Oculus/VR/Prefabs/フォルダのOVRCamera.prefabです。
このプレハブをヒエラルキーにドラッグ&ドロップして追加します。

f:id:takumishinoda:20191222152514p:plain
図16. VR視点のカメラを追加

OVRCameraを追加できたら、元からあった「Main Camera」を削除します。

f:id:takumishinoda:20191222152630p:plain
図17. Main Cameraの削除

次に、OVRCameraRigの設定を下の図18を参考にします。
この設定でカメラがOculusQuest用に設定されます。

f:id:takumishinoda:20191222152700p:plain
図18. OVRCameraRigの設定


5. 実機で動かす

ついに実機で動かす段階まで来ました。
前章でVR視点のカメラオブジェクトだけを追加したので実機で動かすと360°何もない空間が見えるようになります。
予めOculusQuestは開発者モードにしておき、PCにUSB接続しPCからのUSBデバッグを許可しておきましょう。 それでは実機で動かしてみましょう。

再度「Builld Settings」画面を開いて「Build And Run」ボタンを押して実機実行します。

f:id:takumishinoda:20191222153303p:plain
図19. Builld Settingsからビルド実行

ビルドが始まる前に、ビルド名とビルド先を設定します。
設定が終わったら「save」ボタンを押してビルドします。
このビルドも時間が掛かる作業になるのでくつろいで待ちましょう。
ビルドが終わるとOculusQuest側で勝手にアプリが立ち上がるので、動作を確認しましょう。

f:id:takumishinoda:20191222153346p:plain
図20. ビルド名・ビルド先設定

無事実機確認がとれれば、これでOculusQuestの開発環境が整ったことになります。


終わりに

OculusQuestを開発する時MacbookとType-C一本ですむのでVR開発もとても便利になったと思います。
ただ、開発時に毎回ビルドして実機デバッグでは時間がかなり掛かる様な気がするので何か方法があればまた記事にしたいと思います。


参考:

qiita.com