AR Foundation アプリで AR を有効にする(Android のみ)

新規または既存のアプリで拡張現実(AR)機能を使用するには、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 なしでは動作できません。ご利用には、AR 用 Google Play 開発者サービスがインストールされた ARCore 対応デバイスが必要です。

  • Google Play ストアでは、ARCore をサポートするデバイスでのみ AR 必須アプリを利用できるようになります。
  • AR 必須アプリをインストールすると、Google Play ストアによってデバイスに Google Play 開発者サービス(AR)が自動的にインストールされます。ただし、Google Play 開発者サービス(AR)が古い場合や手動でアンインストールされた場合に備えて、アプリは追加のランタイム チェックを実行する必要があります。

AR オプション アプリは、ARCore を使用して既存の機能を強化します。オプションの AR 機能は、AR 用 Google Play 開発者サービスがインストールされている ARCore 対応デバイスでのみ有効になります。

  • AR オプション アプリは、ARCore に対応していないデバイスにインストールして実行できます。
  • ユーザーが AR オプション アプリをインストールしても、Google Play ストアによってデバイスに Google Play 開発者サービス(AR)が自動的にインストールされることはありません
AR が必要AR(オプション)
AR 機能の使用 アプリの基本的な機能には ARCore が必要です。 ARCore はアプリの機能を強化します。アプリは ARCore サポートなしでも実行できます。
Google Play ストアの公開設定 お客様のアプリは、ARCore をサポートするデバイスの Google Play ストアにのみ掲載されます。 アプリは通常のリスト手順に沿っています。
Google Play 開発者サービス(AR)のインストール方法 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 を使用する必要があります。
必須 ARSession.Install() コルーチン Google Play 開発者サービス(AR)をインストール

アプリを AR 必須にする

Android

  1. Edit > Project Settings > XR Plug-in Management > ARCore に移動します。Requirement はデフォルトで Required に設定されています。

  2. Edit > Project Settings > Player をクリックし、Android アイコンをクリックします。

  3. Other Settings > Identification で、 Minimum API Level24 以上)。

iOS

  1. Edit > Project Settings > XR Plug-in Management > ARKit に移動します。Requirement はデフォルトで Required に設定されています。

  2. Edit > Project Settings > Player をクリックし、iOS の アイコンをクリックします。

  3. Other Settings > Configuration で、 Target minimum iOS Version

アプリを AR オプションにする

Android

  1. Edit > Project Settings > XR Plug-in Management > ARCore に移動します。

  2. [Requirement] プルダウン メニューから [Optional] を選択します。 アプリを AR オプションに設定します。

  3. Edit > Project Settings > Player をクリックし、Android アイコンをクリックします。

  4. Other Settings > Identification で、 Minimum API Level24 以上)。

iOS

  1. Edit > Project Settings > XR Plug-in Management > ARKit に移動します。

  2. [Requirement] プルダウン メニューから [Optional] を選択します。 アプリを [AR Optional] に設定します。

  3. Edit > Project Settings > Player をクリックし、iOS の アイコンをクリックします。

  4. Other Settings > Configuration で、 Target minimum iOS Version

ランタイム チェックを行う

AR 用 Google Play 開発者サービスがインストールされているかどうかを確認する

AR 必須アプリと AR オプション アプリの両方で使用が必須 ARSession.Install() コルーチン を使用して、ARCore セッションを作成する前に、互換性のあるバージョンの Google Play 開発者サービス(AR)が(まだ)インストールされているかどうか、必要な ARCore デバイス プロファイル データがすべてダウンロードされていることを確認します。

AR 必須アプリは実行時に、以下の目的のためにランタイム チェックを自動的に実行します。 対象デバイスが次の要件を満たしていることを確認します。

  • ARCore のサポート
  • Google Play Services for AR がインストールされている - インストールされていない場合 (ユーザーによって削除された可能性があります)か、バージョンが古すぎる場合は、 ユーザーにインストールまたは更新を求めるメッセージが表示されます。
  • ARCore のデバイス プロファイル データが最新である(データが古い場合は、アプリ)。 新しいデータをダウンロードします

これらのデフォルトのチェックを無効にするには、ARSession.attemptUpdatefalse に設定します。アプリ 引き続き次の条件を処理します。

条件 アクション
デバイスが ARCore に対応していません。 AR 関連の機能は表示されません。
デバイスは ARCore をサポートしているが、Google Play Services for AR または ARCore のデバイス プロファイル データがインストールされていないか、最新ではありません。 Google Play Services for AR をインストールまたは更新するようユーザーに求める。 呼び出しによる ARCore デバイス プロファイル データ ARSession.Install()
デバイスは ARCore と Google Play Services for AR をサポートしており、 ARCore のデバイス プロファイル データがインストールされ、最新の状態である。 ARCore Session を作成し、ARCore の使用を開始します。

ARSession.state でインストールとサポートの状態を確認することもできます。

ユーザーのプライバシー要件を遵守する

Google Play ストアでアプリを公開するには、アプリが ARCore の ユーザーのプライバシー要件

次のステップ