本文へスキップ
バージョン： 3.12

Unity用Niantic SDKのセットアップ

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

ベータコンテンツ

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

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

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

注意！

SessionStateChangedEventUnit エラー](./release_notes/release3.0.md#known-issues) を回避するには、Unity 2022 LTS ユーザーは 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...**を選択します。

    パッケージ・マネージャー・メニュー

  4. https://github.com/niantic-lightship/ardk-upm.git\`と入力する。
    1. プロンプトが表示されたら、Yesをクリックして、ARFoundation 5.0の新しい入力システムパッケージをアクティブにします。 この際、Unityエディターの再起動が必要になることがあります。
  5. SharedARパッケージを追加するには、代わりに以下のURLを使用してこれらの手順を繰り返します：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. ライトシップトップメニューを開き、設定を選択してライトシップ設定メニューを開きます。 認証情報の下にあるAPIキーを取得をクリックします。 lightship.devのWebサイトがブラウザのウィンドウで開きます。
  2. Lightshipアカウントが必要な場合は、新しく作成してログインします。
  3. プロジェクト**ページを開き、既存のプロジェクトを選択するか、**新規プロジェクト**をクリックして新規プロジェクトを作成します。
  4. プロジェクトの概要で、API Keyの横にあるコピーアイコンをクリックしてコピーします。
  5. UnityのLightship Settingsウィンドウに戻り、API KeyをAPI Keyフィールドに貼り付けます。

モバイル・プラットフォーム用XRローダーの有効化​

注意

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

  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までスクロールダウンし、以下の設定を変更します：
  • レンダリング-自動グラフィックスAPIのチェックを外します。 Graphics APIリストにVulkanが表示されている場合は、削除してください。
  • 識別-最小APIレベルをAndroid 7.0 'Nougat' (API Level 24)以上に設定します。
  • 設定-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のインストール先のローカルパスに置き換えます。
カスタムGradleビルド設定
ヒント

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

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

次のステップ​

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

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

  1. 新しいベーシックシーンを作成する：
    1. メインメニューから、File > New Sceneを選択します。
    2. Basic(Built-in)**を選択し、**Create**をクリックします。
  2. メインカメラ**を右クリックし、**削除**を選択します。
  3. 新しいシーンにARSessionとXROriginを追加します。
    1. 階層**で新しいシーンを選択してください。
    2. メインメニューから、Game Object > XR > AR Session を選択します。
    3. XR Origin (Mobile AR)**を追加するには、これを繰り返します。
  4. ファイル** > **保存**を使用してシーンを保存します。
ヒント

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

さらに詳しく​

ここから、サンプル・プロジェクト・ページに進んで機能を試してみたり、ハウツー・ページに進んでガイド付きチュートリアルで試してみてください。 ARDK 3に変換したい以前のARDKプロジェクトがある場合は、移行ガイドを参照してください。