本文へスキップ

ARDK 3のセットアップ

ARDKをセットアップするには、以下のことが必要です：

  1. Unityをダウンロードしてインストールします。
  2. git url または tarballからARDKプラグインをインストールしてください。
  3. モバイルプラットフォームを選択.
  4. Lightshipの起動.
  5. APIキー をUnityプロジェクトに追加します。
  6. Unity 2022.3.15f1 またはそれ以前を使用している場合は、Gradle for Android をインストールしてください。
  7. プロジェクトにARシーンを設定する。
  8. Next Steps に沿って、ARDKの詳細を学び、使い始めてください。
注意

ARDKが使用するAPIキーを提供するには、 https://lightship.dev のアカウントが必要です。 アカウントをお持ちでない場合は、 https://lightship.dev/signin/create-account にアクセスの上、アカウントを作成してください。

対応Unityバージョン

UnityサポートをUnity 2021 LTSにアップグレードしました。 2021.3.33f1をサポートしています。

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

URLを使ってARDKプラグインをインストールする​

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

      Package Manager メニュー

    2. https://github.com/niantic-lightship/ardk-upm.gitを入力します。
    3. Yes（はい） をクリックして、AR Foundation 5.0の新しい入力システムパッケージを有効にします（プロンプトが表示された場合）。
  3. 共有ARプラグインをインストールするには、 https://github.com/niantic-lightship/sharedar-upm.gitを使用して、前の手順を繰り返します。

ARDKプラグインをTarballからインストールします​

  1. 最新リリースからプラグインパッケージ (.tgz) をダウンロードしてください：
    1. ardk-upm.
    2. sharedar-upm.
  2. 3D (Core) テンプレートで新しい Unity プロジェクトを作成します。
  3. Unity プロジェクトで、 Window > Package Managerを選択して、 Package Manager を開きます。
    1. パッケージマネージャータブの+（プラス）メニューから、 Add package from tarball...（tarballからパッケージを追加...） を選択します。

      Package Managerメニュー

    2. ARDK をダウンロードした場所に移動し、ダウンロードした .tgz ファイルを選択し、 Openを押します。 Niantic Lightship AR Plugin フォルダとして、パッケージがプロジェクトの Packages フォルダにインストールされます。
    3. Yes をクリックして、ARFoundation 5.0 用の新しい入力システム パッケージをアクティブにします（プロンプトが表示された場合）。
  4. 共有ARプラグインをインストールするには、 sharedar-upmのために前のステップを繰り返す。
ヒント

これ以降は、 Project Validation ツールを使用することで、ほとんどのセットアップ作業をより速く行うことができます。 Fix と Fix All ボタンを使ってステップを自動化し、自動化できないステップについては、手動で設定する必要があるオプションへのショートカットを提供します。

Lightship Pluginの有効化​

  1. トップメニューで、 Lightship > XR Plug-in Management を選択し、 XR Plug-in Management メニューに移動します。
  2. XR Plug-in Management メニューで、開発したいプラットフォームを選択し、 Niantic Lightship SDKと書かれたボックスにチェックを入れます。
    • Androidの場合は、 Niantic Lightship SDK + Google ARCoreを選択してください。
    • iOSの場合は、 Niantic Lightship SDK + Apple ARKitを選択してください。
注意

Unityのバージョン 2022.3.10f1 以上では、この時点でコンソールに エラー が表示されるかもしれません。

UnityプロジェクトにAPIキーを追加する​

  1. lightship.dev をご覧ください。
  2. サインインして、 Projects セクションに移動します。 既存のプロジェクトを選択するか、 New Project で新しいプロジェクトを作成します。
  3. プロジェクトの Overview で、 API Key の横にあるコピーのアイコンをクリックします。
  4. Lightship > Settings の順に選択し、 Lightship の設定を開きます。
  5. 右側の Inspector ウィンドウの適切なフィールドにAPIキーを貼り付けます。

モバイルプラットフォームの選択​

  1. File > Build Settings の順に選択して、 Build Settings ウィンドウを開きます。
  2. iOSまたはAndroidを選択し、 Switch Platform（プラットフォームの切り替え） をクリックします。 進行状況バーが終了したら、 Player Settings をクリックします。
  3. プレイヤー設定（Androidの場合）
    • Other Settings > Rendering の順に移動し、 Auto Graphics API のチェックを外します。 Graphics APIリストに Vulkan が表示されている場合は、削除してください。
    • Other Settings > Minimum API Level（最小のAPIレベル） の順に移動し、最小のAPIレベルを Android 7.0 'Nougat'（APIレベル24） 以上に設定します。
    • Other Settings（その他の設定） > Scripting Backend（スクリプティングバックエンド） の順に移動し、ドロップダウンから IL2CPP を選択し、 ARMv7 と ARM64 の両方を有効にします。
  4. プレイヤー設定（iOSの場合）
    • Other Settings > Identification > Signing Team ID の順に移動し、 developer.apple.com からiOSアプリの開発者キーを入力します。
    • Other Settings > Camera Use Description - ARのユースケースの説明を記入してください（例：「Lightship ARDK」）。
    • Other Settings > Target Minimum iOS Version - 14.0 以上に設定してください。
    • Other Settings > Architecture の順に移動し、 ARM64 を選択します。

UnityにAndroid用Gradleをインストールする​

注意

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

ここをクリックすると、Gradleのインストール手順が表示されます。

  1. GradleのReleasesページ からGradle 6.7.1をダウンロードしてインストールします。

  2. 次の手順に沿って、UnityにデフォルトでインストールされているGradleを置き換えます。

    1. Unityで、 Preferences（環境設定） > External Tools（外部ツール） > Android の順に開きます。

    2. Gradle installed with Unity（推奨） ボックスのチェックを外し、パスをGradle 6.7.1のインストール先のローカルパスに置き換えます。

        <img src={BuildSettingsCustomGradle} alt="Gradleのカスタムビルド設定" width="50%" />

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

      :::

    3. Build Target を Androidに設定する。

  3. カスタムベースのGradleテンプレートを作成する：

    1. Unityのトップメニューで、 Editをクリックし、 Project Settingsをクリックします。
    2. 左側の Project Settings メニューで、 Playerを選択し、Android タブをクリックします。
    3. Publishing Settingsまでスクロールダウンし、 Custom Base Gradle Templateと書かれたボックスにチェックを入れます。 Unityが新しいテンプレートファイルを作成し、そのパスを表示します。 (デフォルトでは、このパスは Assets/Plugins/Android/baseProjectTemplate.gradleになっているはずです)
    カスタムベースのGradleテンプレートを設定する
    1. 新しいGradleテンプレートを開く。 13行目で、 クラスパス「com.android.tools.build:gradle:4.0.1」 を見つけ、末尾のバージョン番号を 4.2.0に更新する。
    2. カスタムGradleテンプレートを保存して閉じます。

次のステップ​

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を使用してシーンを保存します。
ヒント

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

さらに詳しく​

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