AR を有効にすると、新規または既存のアプリで拡張現実機能を使用できます。
AR 必須または AR オプションにアプリを構成する
個々のデバイスの容量を節約するため、AR 機能はすべて、Google Play ストアで個別に更新される「Google Play 開発者サービス（AR）」というアプリに保存されます。AR 機能を使用する Android アプリは、ARCore SDK を使用して AR 用 Google Play 開発者サービスと通信します。AR 機能をサポートするアプリは、AR 必須と AR オプションの 2 つの方法で設定できます。この指定によって、アプリと AR 用 Google Play 開発者サービスのアプリとの連携方法が決まります。
[AR 必須] アプリは、ARCore なしでは機能しません。AR 用の Google Play 開発者サービスがインストールされている ARCore 対応デバイスが必要です。
- Google Play ストアの AR 必須アプリは、ARCore をサポートするデバイスでのみ利用可能になります。
- ユーザーが AR 必須アプリをインストールすると、Google Play ストアの AR 向け Google Play 開発者サービスがユーザーのデバイスに自動的にインストールされます。ただし、Google Play 開発者サービス（AR）が古い場合や手動でアンインストールした場合は、アプリで追加のランタイム チェックを行う必要があります。
AR Optional アプリは、ARCore を使用して既存の機能を強化します。オプションの AR 機能があり、Google Play 開発者サービス（AR）がインストールされている ARCore 対応デバイスでのみ有効になります。
- AR Optional アプリは、ARCore をサポートしていないデバイスにインストールして実行できます。
- ユーザーが AR Optional アプリをインストールしても、Google Play ストアからデバイスに AR 用 Google Play 開発者サービスが自動的にインストールされることはありません。
| AR が必要 | AR（オプション） | |
|---|---|---|
| AR 機能の使用状況 | 基本的な機能を使用するには ARCore が必要です。 | ARCore はアプリの機能を強化します。アプリは ARCore のサポートなしで実行できます。 |
| Google Play ストアの公開設定 | アプリは ARCore をサポートするデバイスの Play ストアにのみ掲載される。 | アプリは通常の掲載情報の手順に沿っている。 |
| AR 用 Google Play 開発者サービスのインストール方法 | Play ストアによって、アプリとともに AR 用 Google Play 開発者サービスがインストールされます。 | このアプリでは ARSession.state を使用して ARCore をダウンロードしてインストールしています。 |
Android minSdkVersion の要件 |
Android 7.0（API レベル 24） | Android 4.4（API レベル 19）。AR 機能を実行するには、Android 7.0（API レベル 24）以上が必要です。 |
ARCore のサポートとインストール ステータスを確認するには、ARSession.state を使用する必要があります |
アプリの 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 に設定します。
Edit > Project Settings > Player をクリックし、iOS アイコンが表示されているタブを選択します。
Other Settings > Configuration で、アプリの Target minimum iOS Version を指定します。
ランタイム チェックを実行する
Google Play 開発者サービス（AR）がインストールされているかどうかを確認する
AR 必須アプリと AR オプションのアプリは、ARCore セッションを作成する前に ARSession.state を呼び出して、互換性のあるバージョンの 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 セッションを構成する方法をご確認ください。