ライトシップARDKのセットアップ
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パッケージをインストールする
- 3D(Core) テンプレートを使用して、新しいUnityプロジェクトを作成します。
- UnityプロジェクトでWindowトップメニューを開き、Package Managerを選択します。
- Package Manager タブのプラスメニューから、 Add package from git URL...を選択してください。
https://github.com/niantic-lightship/ardk-upm.git
を入力します。- プロンプトが表示されたら、[はい]をクリックして、ARFoundation 5.0の新しい入力システムパッケージをアクティブにします。 この場合、Unityエディターの再起動が必要になることがあります。
- SharedARパッケージを追加するには、代わりに次のURLを使用してこれらの手順を
繰り返します: https://github.com/niantic-lightship/sharedar-upm.git.
特定のARDKバージョンを使用するには、リリースページから.tgzを
ダウンロードしてください(ardk-upm、sharedar-upm)。 その後、上記のインストール手順に従い、Git URLの代わりに「Add package from tarball」を選択する。
モバイルプラットフォームの設定
- ライトシップのトップメニューを開き、XRプラグインマネジメントを選択します。
- XR Plug-in Management メニューで、開発したいプラットフォームを選択し、 Niantic Lightship SDKと書かれたボックスにチェックを入れます。
- Androidの場合は、 Niantic Lightship SDK + Google ARCoreを選択してください。
- iOSの場合は、 Niantic Lightship SDK + Apple ARKitを選択してください。
Unityのバージョン2022.3.10f1以降では、この時点でコンソールに良性のエラーが表示されることがあります。
ビルド・プラットフォームの設定
- File > Build Settings の順に選択して、 Build Settings ウィンドウを開きます。
- iOSまたはAndroidを選択し、 Switch Platform(プラットフォームの切り替え) をクリックします。 進行状況バーが終了したら、 Player Settings をクリックします。
Androidプレーヤーの設定:
- 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のインストール手順が表示されます。
GradleのReleasesページ からGradle 6.7.1をダウンロードしてインストールします。
次の手順に沿って、UnityにデフォルトでインストールされているGradleを置き換えます。
Unityで、 Preferences(環境設定) > External Tools(外部ツール) > Android の順に開きます。
Gradle installed with Unity(推奨) ボックスのチェックを外し、パスをGradle 6.7.1のインストール先のローカルパスに置き換えます。
<img src={BuildSettingsCustomGradle} alt="Gradleのカスタムビルド設定" width="50%" />
:::tip コマンドラインでビルドする場合は、Unityのビルドスクリプトで `AndroidExternalToolsSettings.gradlePath` を設定することで、Gradleのパスをカスタマイズできます。:::
Build Target を Androidに設定する。
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 を選択します。
無料ライトシップアカウントの作成とAPIキーの設定
- ライトシップトップメニューを開き、「設定」を選択してライトシップ設定メニューを開きます。 Credentialsの下にあるGet API Keyをクリックします。
- Lightshipアカウントにログインするか、新規無料アカウントを作成してください。
- プロジェクトページを開き、既存のプロジェクトを選択するか、新規プロジェクトをクリックして新規プロジェクトを作成します。
- プロジェクトのOverviewで、API Keyの横にあるコピーアイコンをクリックしてコピーします。
- UnityのLightship Settingsウィンドウに戻り、APIKeyフィールドにAPI Keyを貼り付けます。
次のステップ
基本的なARシーンの設定
自分のARプロジェクトを作り始めるには、まず空のARシーンを作ることから始めます:
- 新しいベーシックシーンを作成する:
- メインメニューから、 File > New Sceneを選択します。
- Basic (Built-in) を選択し、 Createをクリックする。
- Main Camera を右クリックし、 Deleteを選択する。
- ARSession と XROrigin を新しいシーンに追加する
- Hierarchyで新しいシーンを選択してください。
- メインメニューから、 Game Object > XR > AR Sessionを選択します。
- これを繰り返して XR Origin (Mobile AR) を追加します。
- File > Saveを使用してシーンを保存します。
Save As Scene Template を選択すると、次回から New Scene ダイアログでこのシーンを選択できます。
さらに詳しく
ここから、 Sample Projects ページ に進んで機能を試すか、 How-To ページ に進んでチュートリアルで試します。 ARDK 3に変換したい以前のARDKプロジェクトがある場合は、 移行ガイドをご覧ください。