AR を有効にすると、新規または既存のアプリで拡張現実機能を利用できます。
AR 対応を必須または AR オプションにアプリを設定する
個々のデバイスの容量を節約するため、すべての AR 機能は Google Play 開発者サービス（AR）というアプリに保存されます。このアプリは Google Play ストアで別途更新されます。AR 機能を使用する Android アプリは、ARCore SDK を使用して Google Play 開発者サービス（AR）と通信します。AR 機能をサポートするアプリは、[AR 対応が必要] と [AR オプション] の 2 つの方法で設定できます。この指定により、アプリが AR 用 Google Play 開発者サービス アプリとどのようにやり取りするかが決まります。
[AR 必須] アプリは ARCore なしでは機能しません。Google Play 開発者サービス（AR）がインストールされた ARCore 対応デバイスが必要です。
- Google Play ストアでは、ARCore をサポートするデバイスでのみ AR 対応アプリを利用できます。
- ユーザーが AR 必須アプリをインストールすると、Google Play ストアからユーザーのデバイスに Google Play 開発者サービス（AR）が自動的にインストールされます。ただし、Google Play 開発者サービス（AR）が古い場合や手動でアンインストールした場合は、アプリで追加のランタイム チェックを行う必要があります。
AR Optional アプリは、ARCore を使用して既存の機能を強化しています。これには、Google Play 開発者サービス（AR）がインストールされている ARCore 対応デバイスでのみ有効になる、オプションの AR 機能があります。
- AR Optional アプリは、ARCore をサポートしていないデバイスにインストールして実行できます。
- ユーザーが AR Optional アプリをインストールしても、Google Play ストアからデバイスに AR 用 Google Play 開発者サービスが自動的にインストールされることはありません。
| AR が必要 | AR（オプション） | |
|---|---|---|
| AR 機能の使用 | アプリの基本機能には ARCore が必要です。 | ARCore はアプリの機能を強化します。ARCore サポートなしでもアプリを実行できます。 |
| Google Play ストアの公開設定 | Google Play ストアに、ARCore をサポートするデバイスでのみアプリが掲載されている。 | アプリは通常の掲載手順に沿っています。 |
| AR 用 Google Play 開発者サービスのインストール方法 | Google Play ストアにより、アプリとともに Google Play 開発者サービス（AR）がインストールされます。 | アプリは、ARSession.Install() コルーチンを使用して ARCore をダウンロードしてインストールします。 |
Android の minSdkVersion の要件 |
Android 7.0（API レベル 24） | Android 4.4（API レベル 19）。AR 機能を実行するには、Android 7.0（API レベル 24）以上が必要です。 |
ARCore のサポートとインストールのステータスを確認するには、ARSession.state を使用する必要があります
|
||
Google Play 開発者サービス（AR）をインストールするには、ARSession.Install() コルーチンを使用する必要があります。 |
アプリの AR を必須にする
Android
Edit > Project Settings > XR Plug-in Management > ARCore に移動します。Requirement はデフォルトで Required に設定されています。
Edit > Project Settings > Player をクリックして、Android アイコンが表示されているタブを選択します。
Other Settings > Identification で、
24以上の Minimum API Level を指定します。
iOS
Edit > Project Settings > XR Plug-in Management > ARKit に移動します。Requirement はデフォルトで Required に設定されています。
[Edit > Project Settings > Player] をクリックし、iOS アイコンが表示されているタブを選択します。
Other Settings > Configuration で、アプリの Target minimum iOS Version を指定します。
アプリの AR をオプションにする
Android
Edit > Project Settings > XR Plug-in Management > ARCore に移動します。
[Requirement] プルダウン メニューから Optional を選択し、アプリを AR オプションに設定します。
Edit > Project Settings > Player をクリックして、Android アイコンが表示されているタブを選択します。
Other Settings > Identification で、
24以上の Minimum API Level を指定します。
iOS
Edit > Project Settings > XR Plug-in Management > ARKit に移動します。
[Requirement] プルダウン メニューから Optional を選択し、アプリを [AR Optional]（AR オプション）に設定します。
[Edit > Project Settings > Player] をクリックし、iOS アイコンが表示されているタブを選択します。
Other Settings > Configuration で、アプリの Target minimum iOS Version を指定します。
ランタイム チェックを実行する
Google Play 開発者サービス（AR）がインストールされているかどうかを確認する
AR 必須アプリと AR オプションアプリの両方で、ARCore セッションを作成する前に ARSession.Install() コルーチンを使用して、互換性のあるバージョンの Google Play 開発者サービス（AR）が（まだ）インストールされていることを確認し、必要な ARCore デバイス プロファイル データがすべてダウンロードされていることを確認する必要があります。
実行時に、AR 必須アプリはランタイム チェックを自動的に実行し、対象デバイスが次のことを確認します。
- ARCore のサポート
- Google Play Services for AR がインストールされていること。インストールされていない場合（ユーザーが削除した場合など）またはバージョンが古すぎる場合は、ユーザーにインストールまたは更新を求めるメッセージが表示されます。
- 最新の ARCore デバイス プロファイル データがある。最新ではない場合、アプリは新しいデータをダウンロードします。
これらのデフォルトのチェックを無効にするには、ARSession.attemptUpdate を false に設定します。この場合も、アプリで以下の条件を処理する必要があります。
| 条件 | アクション |
|---|---|
| デバイスが ARCore をサポートしていない。 | AR 関連の機能を非表示にします。 |
| デバイスは ARCore をサポートしていますが、Google Play Services for AR や ARCore のデバイス プロファイル データがインストールされていないか、最新ではありません。 | ARSession.Install() を呼び出して、Google Play Services for AR や ARCore のデバイス プロファイル データをインストールまたは更新するようユーザーに求めます。 |
| デバイスが ARCore と Google Play Services for AR をサポートしており、ARCore のデバイス プロファイル データがインストールされ、最新の状態である。 | ARCore Session を作成し、ARCore の使用を開始します。 |
ARSession.state でインストールとサポートの状態を確認することもできます。
ユーザーのプライバシー要件を遵守する
Play ストアでアプリを公開するには、アプリが ARCore のユーザー プライバシー要件を遵守していることをご確認ください。
次のステップ
- ARCore セッションを構成する方法を確認する。