Unity用Niantic SDKのセットアップ

SDKをセットアップするには、Unityをダウンロードしてインストールし、ARDKのUnityパッケージをインストールして、AR体験が実行されるプラットフォーム用にUnityをセットアップします。 その後、APIキーでUnityのLightshipを認証し、プラットフォームデバイスに必要な追加設定を行い、UnityでARシーンの基本要件を設定します。

ベータ版コンテンツ

Lightship Magic Leap 2の統合はベータ版であるため、一部の機能が期待通りに動作しない可能性があります。

Unityのダウンロードとインストール

Unityをダウンロード します。 Unity 2022 LTS（2022.3.37f1）と2021 LTS（2021.3.37f1）をサポートしています。

注意してください！

Unity 2022 LTS ユーザーは、SessionStateChangedEventUnit エラーを回避するため、パッケージマネージャー経由で Visual Scripting を1.9.0から1.9.1以降に手動でアップグレードする必要があります。

プロジェクトの作成とARDKのインストール

1. 3D（Core） テンプレートを使用して、新しいUnityプロジェクトを作成します。
2. Unityプロジェクトで、 Window トップメニューを開き、 Package Manager を選択します。
3. Package Manager タブのプラスメニューから、 **Add package from git URL...**を選択してください。

   

4. https://github.com/niantic-lightship/ardk-upm.gitを入力します。
   1. 新しいInput System PackageをARFoundation 5.0用に有効化するよう求められたら、 Yes をクリックしてください。 この際、Unityエディターの再起動が必要になることがあります。
5. SharedARパッケージを追加するには、 https://github.com/niantic-lightship/sharedar-upm.git から、同じ手順を繰り返します。
6. Magic Leap 2パッケージを追加するには、代わりに次のURLを使用してこれらの手順を繰り返します： https://github.com/niantic-lightship/ardk-ml2-upm.git.

特定のARDKバージョンを使用するには、リリースページから.tgzをダウンロードしてください（ardk-upm、sharedar-upm、ml2-upm）。 その後、上記のインストール手順に従い、Git URLではなく、「Add package from tarball」を選択します。

Unityでモバイルプラットフォームを設定する

Android

1. Niantic SDKのトップメニューを開き、XR Plug-in Managementを選択します。
2. XRプラグイン管理」メニューで「Android」タブを選択し、「Niantic Lightship SDK + Google ARCore」と書かれたボックスにチェックを入れます。

iOS

1. Niantic SDKのトップメニューを開き、XR Plug-in Managementを選択します。
2. XRプラグイン管理メニューで、iOSタブを選択し、Niantic Lightship SDK + Apple ARKitと書かれたボックスにチェックを入れます。

Magic Leap 2

Magic Leap 2のユーザーは、セットアッププロセスの後半でモバイルプラットフォームを設定する。

注意

Unityのバージョン2022.3.10f1以降では、この時点でコンソールに良性のエラーが表示されることがあります。

ビルドプラットフォームを設定する

1. File > Build Settings の順に選択して、 Build Settings ウィンドウを開きます。
2. iOSまたはAndroidを選択し、 Switch Platform（プラットフォームの切り替え） をクリックします。 進行状況バーが終了したら、 Player Settings（プレイヤー設定） をクリックします。 タブからプラットフォームを選択し、「その他の設定」までスクロールダウンし、以下の設定を変更します：

Android

• レンダリング-自動グラフィックスAPIのチェックを外します。 もしVulkanがGraphics APIリストに表示されたら、それを削除してください。
• 識別-最小APIレベルをAndroid 7.0 'Nougat' (API Level 24)以上に設定する。
• 設定-スクリプト・バックエンドを IL2CPPに設定し、ARMv7と ARM64の両方を有効にする。

::注意 注意！
Unity 2022.3.15f1以前を使用している場合、AndroidへのビルドにはGradleのカスタムインストールが必要です。 :::

Gradleのインストール手順を表示するには、ここをクリックしてください

1. Gradle Releases page](https://gradle.org/releases/#6.7.1)からGradle 6.7.1をダウンロードしてインストールします。
2. Unity のデフォルトの Gradle インストールを置き換える:
3. Unityで、Preferences > External Tools > Androidを開きます。
4. Gradle installed with Unity (recommended)** というラベルの付いたボックスのチェックを外し、パスを Gradle 6.7.1 のローカルインストールに置き換えます。

ヒント

コマンドラインでビルドする場合、UnityのビルドスクリプトでAndroidExternalToolsSettings.gradlePathを設定することでGradleのパスをカスタマイズできます。

1. ビルドターゲットをAndroid**に設定します。

iOS

• Identification>Signing Team ID-developer.apple.comからiOSアプリの開発者キーを入力します。
• Camera Use Description- 「Lightship ARDK」のように、ARをどのように使用しているかを記述する。
• 対象iOSの最小バージョン-14.0以上に設定します。
• アーキテクチャ-ARM64を選択。

Magic Leap 2

• レンダリング-自動グラフィックスAPIのチェックを外します。

ライトシップのアカウントを作成し、APIキーを追加する

1. Lightship トップメニューを開き、 設定 を選択して、Lightshipの設定メニューを開きます。 Credentialsの下にあるGet API Keyをクリックします。 これにより、lightship.devのウェブサイトがブラウザウィンドウで開きます。
2. 必要であれば、ライトシップのアカウントを新規作成し、ログインしてください。
3. プロジェクトページを開き、既存のプロジェクトを選択するか、新規プロジェクトをクリックして新規プロジェクトを作成します。
4. プロジェクトの 概要 ページで、APIキーの横にあるコピーアイコンをクリックしてAPIキーをコピーします。
5. Unityの Lightship設定 ウィンドウに戻り、APIキーを APIキー フィールドに貼り付けます。

ヘッドマウントディスプレイの構成

ヘッドマウントディスプレイ(HMD)用に開発する場合は、セットアップ手順を完了してから続行してください。 そうでない場合は、このセクションは飛ばしていただいて結構です。

Magic Leap 2

Magic Leap 2のセットアップ手順を拡大するには、ここをクリックしてください

1. Magic Leap開発者ポータル](https://ml2-developer.magicleap.com/downloads)からMagic Leap Hub 3をダウンロードしてインストールする。

2. Unityを開き、3D（Core）テンプレートとBuilt-In Rendering Pipelineを使用して新しいプロジェクトを作成します。

3. Magic Leap 2のオペレーティングシステムがバージョン1.10であることを確認してください:

   1. Settingsアプリで、Aboutセクションを見つけてください。
   2. OSバージョンまでスクロールダウンしてください。 1.10と表示されれば完了だ！
   3. バージョンが1.10より低い場合は、以下の手順に従って、Magic Leap 2 Updaterを使ってデバイスをアップデートしてください。
   4. バージョンが1.10より高い場合は、デバイスをマシンに接続し、Magic Leap Hub 3を使用してOSをダウングレードするには、以下の手順に従ってください。

4. Magic Leap 2で開発者モードとUSBデバッグを有効にする:

   1. SettingsアプリのAboutセクションに戻る。
   2. 製造番号までスクロールダウンしてください。 これを7回クリックすると、開発者モードが有効になります。
   3. System設定メニューを開き、Advancedまでスクロールダウンし、Developer Optionsを開きます。
   4. Debuggingで、USB Debuggingを有効にしてください。
   5. デバイスを接続すると、プロンプトが開きますので、USBデバッグを許可を選択してください。 今後このステップをスキップするには、Always allowをチェックします。

5. Magic Leap SDKと依存関係をインストールします：

   1. Magic Leap Hubを開き、パッケージの左側のメニューから下にスクロールしてユニティパッケージを選択します。 バージョン**のドロップダウンメニューから、2.5.0を選択し、インストールします。
   

   2. Unityパッケージをインストール後、PackagesメニューからML C SDKを探します。 それを選択し、バージョンのドロップダウンメニューから1.10.0を選択してインストールします。

      

   3. Magic Leap 2の電源を入れ、USBで接続します。 デバイス上のプロンプトでコンピュータへの接続を承認する必要がある場合があります。

6. Unity Asset StoreからUnityアカウントにMagic Leap Setup Toolを追加します。

7. UnityのNiantic SDKトップメニューを開き、XR Plug-in Managementを選択します。

   1. XRプラグイン管理**メニューで、Androidタブを選択し、OpenXRと書かれたボックスにチェックを入れます。
   2. Magic Leap feature groupとNiantic SDK + Magic Leap feature group**と書かれたボックスにチェックを入れてください。

8. Magic Leap Setup ToolをUnityプロジェクトにインポートします。

   1. Unityのウィンドウトップメニューを開き、パッケージマネージャを選択します。
   2. パッケージを展開します：In Project** ドロップダウンメニューを展開し、My Assets を選択します。
   3. Magic Leap Setup Tool**を選択し、Importをクリックします。
   4. と聞かれたら、Use OpenXRを選択してください。
   5. 終了すると、セットアップツールが自動的に開きます。

9. セットアップツール**を使用してプロジェクトをセットアップします。

   1. Set Magic Leap SDK Folder**ボタンをクリックし、お使いのマシンでmlsdkフォルダを見つけて開きます。 macOSでは、~/MagicLeap/mlsdkにある。 v1.10.0`フォルダを選択する。
   2. ビルドターゲットをAndroidに設定する**の横にある、設定を修正するをクリックします。
   3. Magic Leap SDKをインポートします：
      1. パッケージのインポート]をクリックします。
      2. Magic Leapレジストリの使用を促されたら、Use Local Copyを選択します。
      3. Magic Leapのunityディレクトリを見つけて開く。 macOSでは、これは ~/MagicLeap/tools/unity にある。 v2.5.0フォルダを開き、com.magicleap.unitysdk.tgz`パッケージを選択する。
      4. 残りのセットアップ手順を自動化するには、Apply Allをクリックします。 表示される設定プロンプトに対して、ContinueとYesを選択します。

10. Niantic SDK ML2パッケージをアクティベートします：

    1. Niantic SDK Magic Leap Plugin](https://github.com/niantic-lightship/ardk-ml2-upm/releases)と[Niantic SDK AR Plugin](https://github.com/niantic-lightship/ardk-upm/releases)がパッケージマネージャーにインストールされていることを確認してください（[ARDKのインストール](./setup.md#create-a-project-and-install-ardk)を参照）。
    2. XRプラグイン管理**メニューでAndroidタブを選択し、OpenXR、Niantic Lightship SDK + Magic Leap feature group、Magic Leap feature groupにチェックを入れます。
    
    2. Niantic SDK** トップメニューの Set Up ML2 ボタンをクリックします。

11. 以下のUnityの設定が正しいことを確認してください。 これらはすでに適切に設定されているはずだが、何か問題が発生した場合は、まずこれらの設定を再確認することをお勧めする。

    1. ユニティトップメニュー -> 設定 -> 外部ツール：
       1. Gradle、Android SDK、NDKがUnityのデフォルトに設定されていることを確認する。
    2. Unityプロジェクト設定メニューで
       1. Magic Leap**メニューを展開し、Permissionsを選択します。 すべての許可が選択されていることを確認してください。
       
       1. XRプラグイン管理**メニューで

          1. 左側のメニューからOpenXRを選択し、Androidタブをクリックします。 これらの必要なFeature Groupが有効になっていることを確認してください。

             

          2. Magic Leap 2 Supportの横にある設定エディタを開きます。 知覚スナップショットと書かれたボックスにチェックを入れる。

             

          3. すべての機能**で、Lightship Magic Leap Features Integrationがチェックされていることを確認してください。

          4. 左側のメニューからProject Validationを選択します。 Androidタブを選択し、ウィンドウにエラーがないことを確認する。 Lightship ARDK for Androidを使用している場合...」の警告は、ML2用にビルドする場合は無視すること。

12. すべてのチェックが終わったら、Build Settings メニューを開き、ML2を接続した状態でBuild and Run をクリックします。

::注意 注意！
ビルドオプションでデバッガーを待つ**を選択した場合、続行するにはパックのボリュームボタンを押す必要があります。 ML2には近接センサーが搭載されているため、プロジェクトの実行には装着が必要な場合があります。 :::

ヒント

次のステップについては、Magic Leap 2用のLightshipサンプルシーンを試すか、Magic Leap 2用のLightshipでの開発について学んでください。

次のステップ

基本的なARシーンを設定する

自分のARプロジェクトを作り始めるには、まず空のARシーンを作ることから始めます：

1. 新しいベーシックシーンを作成する：
   1. メインメニューから、 File > New Sceneを選択します。
   2. Basic (Built-in) を選択し、 Createをクリックする。
2. Main Camera を右クリックし、 Deleteを選択する。
3. ARSession と XROrigin を新しいシーンに追加する
   1. Hierarchyで新しいシーンを選択してください。
   2. メインメニューから、 Game Object > XR > AR Sessionを選択します。
   3. これを繰り返して XR Origin (Mobile AR) を追加します。
4. File > Saveを使用してシーンを保存します。

ヒント

シーンテンプレートとして保存を選択すると、次回から新規シーンダイアログでこのシーンを選択することができます。

さらに詳しく

ここから、 サンプルプロジェクト ページ に進んで機能を試すか、 How-To ページ に進んでガイド付きチュートリアルで試します。 ARDK 3に変換したい以前のARDKプロジェクトがある場合は、 移行ガイド をご覧ください。