本文へスキップ

Niantic SDK for Unityの設定

重要！

ARDK 3.13.0は2025年4月23日にリリースされます。 ARDK 2.xを含む3.13.0以前のすべてのバージョンは、2025年5月1日から6ヶ月間のサポート期間に入り、2025年11月1日に動作を停止します。 3.13.0リリースノートを参照してください。 お問い合わせはこちらまで support@nianticspatial.com

SDKを設定するには、Unityをダウンロードしてインストールし、ARDKのUnityパッケージをインストールします。次に、AR体験を実行するプラットフォームに合わせてUnityの設定を行います。 その後、Unity内でAPIキーを使ってLightshipを認証し、使用するプラットフォームデバイスに応じてその他の必要な設定を行います。最後に、UnityでARシーンの基本要件を設定します。

ベータ版の注意事項

Lightship Magic Leap 2の統合は現在ベータ版のため、一部の機能が正常に動作しない場合があります。

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

Unityをダウンロード。 Unity 6 (6000.0.36f1) と Unity 2022 LTS (2022.3.57f1) をサポートしています。

注意！

Unity 2022 LTSを使用しているユーザーは、SessionStateChangedEventUnitエラーを回避するため、Package Managerを使用して、Visual Scriptingを 1.9.0 から 1.9.1 以降に手動でアップグレードする必要があります。

注意！

Unity 6はデフォルトで**Universal Render Pipeline (URP)**を使用します。 ARDK を Unity 6 で使用するには、プロジェクト作成時に Built-in Render Pipeline テンプレートを選択するか、How to Set Up ARDK with the Universal Render Pipeline の手順に従って ARDK の URP サポートを有効にする必要があります。

プロジェクトを作成し、ARDKをインストールする​

プロジェクトを作成し、ARDKをインストールする​

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

    Package Manager menu

  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 を使用して同じ手順を繰り返します。

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

注意！

Universal Render Pipeline（URP）を使用している、または使用する予定の場合は、How to Set Up ARDK with Universal Render Pipelineを参照して、セットアップ手順を追加してください。

Lightshipのアカウントを作成してAPIキーを設定する​

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

モバイル向けXR Loaderを有効化する​

注意

Unity 2022.3.10f1 以降のバージョンでは、以下の手順を実行するとコンソールに無害なエラーが表示される場合があります。

  1. Lightship のトップメニューを開き、 XR Plug-in Management を選択します。
  2. XR Plug-in Management メニューでAndroidタブを開き、 Niantic Lightship SDK + Google ARCore のチェックボックスをオンにします。

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

  1. File > Build Settings の順に選択して、 Build Settings ウィンドウを開きます。
  2. iOSまたはAndroidを選択し、 Switch Platform（プラットフォームの切り替え） をクリックします。 進行状況バーが終了したら、 Player Settings をクリックします。 タブからプラットフォームを選択し、 Other Settings まで下にスクロールして、次の設定を変更します。
  • Rendering（レンダリング） に移動し、 Auto Graphics API のチェックを外します。 Graphics APIのリストに Vulkan が含まれている場合は削除します。
  • Identification - Minimum API Level を Android 7.0 'Nougat' （API Level 24） 以上に設定します。
  • Configuration - Scripting Backend を IL2CPP に設定し、 ARMv7 と ARM64 の両方を有効にします。
注意！Unity 2022.3.15f1 以前を使用している場合、AndroidへのビルドにはGradleのカスタムインストールが必要です。
クリックして、Gradleのインストール手順を表示
  1. GradleのリリースページからGradle 6.7.1をダウンロードしてインストールします。
  2. 次の手順に沿って、UnityにデフォルトでインストールされているGradleを置き換えます。
  3. Unityで、 Preferences > External Tools > Android の順に開きます。
  4. Gradle installed with Unity（推奨） というボックスのチェックを外し、パスをGradle 6.7.1のインストール先のローカルパスに置き換えます。
Custom Gradle Build Settings
ヒント

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

  1. Build Target を Android に設定します。

次のステップ​

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

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

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

Save As Scene Template を選択すると、次回から New Scene ダイアログでこのシーンを選択できます。

さらに詳しく​

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