本文へスキップ
バージョン: 3.4

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 ツールを使用することで、ほとんどのセットアップ作業をより速く行うことができます。 FixFix 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 を選択し、 ARMv7ARM64 の両方を有効にします。
  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 TargetAndroidに設定する。

  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. ARSessionXROrigin を新しいシーンに追加する
    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プロジェクトがある場合は、 移行ガイドをご覧ください。