Zenn
💠

公式に則って進めるAR開発1+2+3~Oculus(Meta Quest 3s)~

2025/01/03に公開
Unity
AR
MR
xr
metaquest3s
tech

6000でのやり直し記事です。

XR開発用にUnityをセットアップする

開発要件 自前環境
Unity ID 作成済み
Windows10+(64bit) Windows11 Home 24H2
Unity Editor 2021LTS+
- Android Build Support
- Open JDK
- Android SDK & NDK		 6000.0.32f1 LTS

新規Unityプロジェクトの作成

  1. Universal Render Pipeline 3Dでプロジェクトを作成
  2. 名前とか場所とかを入力して作成

Meta XR all in one SDKをインポート

  1. UnityAsset Storeにサインイン
  2. Meta XR All in One SDKのページにアクセス
  3. Add to My Assetsする
  4. Open Unity Editorが出てくるのでそうする
  5. UnityのPackage Managerが開くので、Meta XR All-in-One SDKのinstallをする

Build Profilesを設定する

  1. Unity Editorで Build ProfilesをAndroidに設定する

Oculus XR Pluginをインストールする

  1. Edit > Project Settings > XR Plugin Management
  2. Install XR Plugin Managementを選択する
  3. PCタブ, AndroidタブのOculusを選択
  4. Window > Package Manager > Packages: InProject
  5. Oculus XR Pluginが入っていることを確認する

Project Setup Toolでプロジェクトを構成する

  1. Meta > Tools > Project Setup Tool
  2. Outstanding IssuesをFix Allする
  3. Recommended ItemsをApply Allする

本体セットアップ

以前やりました

ソフトウェアアップデート

設定 > 一般 > ソフトウェアアップデート

Type version
version 71.0.0.605.522.665334826
Runtime version 71.0.0.612.529.665334779
OS version SQ3A.220605.009.A1

パススルー用の開発環境に変更

  1. Assets > Sceneに新しいシーンの作成。もう2025ですね。
  2. メインカメラ、ライトを削除
  3. Packages > Meta XR Core SDK > Prefabs > OVRCameraRig.prefabをSceneに追加
  4. HierarchでOVRCameraRigを選択
  5. InspectorタブOVRManagerで操作を行う
    1. QuestFeatures > General > Passthrough SuppotリストでSupportedを選択してパススルーを使用するためのビルドコンポーネントを有効にする。
    2. Inside Passthrough & Guardian Boundary > Enable Passthroughにチェックを入れる
    3. Add Component > OVR Passthrough Layer(Script)
    4. OVR Passthrough Layer (Script) > Project SurfaceでReconstructed(自動環境奥行き再構築)若しくはUser Defind (ユーザ定義)を選択。今回は自動にした
    5. Compositingで表示物の設定を行う。今回はUnderlay
      項目 種類 詳細
      Placement Overlay バーチャルコンテンツの上にパススルーを描画
      Underlay パススルーの上にバーチャルコンテンツを描画
      Composition Depth NUM 値が小さいほど前面に表示される

パススルーの基本的なチュートリアル

設定

  1. Edit > Project Settings > Player > Other Settings
    設定項目 設定内容
    Rendering > Color Space Linear
    Configuration > Scripting Backend IL2CPP
    ARMv7 Check Out
    ARM64 Check In
  2. Oculus XR Pluginをインストール
    1. Edit > Project SettingsのXR Plug-in Management > Oculusをオン

    2. OculusのTarget DeviceをMeta Quest 3Sに変更

3Dオブジェクトの追加

  1. GameObject > 3D Object > Cube
  2. Inspector > Transformを適当に設定
  3. AssetsにMaterialsというフォルダを作成した
  4. Assets > Create > Material => Cube-Color と名付ける
  5. Inspector > Surface Inputs > Base Mapで色を選定
  6. マテリアルを立方体にD&D

パススルーの統合

  1. OVRCameraRig > Inspector >
    設定項目 設定内容
    OVRManager > Tracking > Tracking Origin Type Stage
    OVRManager > Quest Features > General > Passthrough Support Supported
    OVRManager > Insight Passthrough & Guardian Boundary Enable Passthrough
    Add Component OVRPassthrough Layer (Script)
    OVR Passthrough Layer (Script) > Compositing > Placement Underlay
  2. Window > Rendering > Lighting > Environment > SkyboxMaterialをNoneにする
  3. OVRCameraRig > TrackingSpace > CenterEyeAnchor > Inspector > Environment
    設定項目 設定内容
    Background Type Solid Color
    Background Black & alpha=0 (RGBA=>all 0)
  4. Meta > Tools > Project Setup ToolsでFix Allするのです

Build & Run

成功しました
わあい

Discussion