新規または既存のアプリで拡張現実(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
Edit > Project Settings > XR Plug-in Management > ARCore に移動します。Requirement はデフォルトで Required に設定されています。
Edit > Project Settings > Player をクリックし、Android アイコンをクリックします。
Other Settings > Identification で、 Minimum API Level(
24
以上)。
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 で、 Minimum API Level(
24
以上)。
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。
ランタイム チェックを行う
AR 用 Google Play 開発者サービスがインストールされているかどうかを確認する
AR 必須アプリと AR オプション アプリの両方で使用が必須
ARSession.Install()
コルーチン
を使用して、ARCore セッションを作成する前に、互換性のあるバージョンの Google Play 開発者サービス(AR)が(まだ)インストールされているかどうか、必要な ARCore デバイス プロファイル データがすべてダウンロードされていることを確認します。
AR 必須アプリは実行時に、以下の目的のためにランタイム チェックを自動的に実行します。 対象デバイスが次の要件を満たしていることを確認します。
- ARCore のサポート
- Google Play Services for AR がインストールされている - インストールされていない場合 (ユーザーによって削除された可能性があります)か、バージョンが古すぎる場合は、 ユーザーにインストールまたは更新を求めるメッセージが表示されます。
- ARCore のデバイス プロファイル データが最新である(データが古い場合は、アプリ)。 新しいデータをダウンロードします
これらのデフォルトのチェックを無効にするには、ARSession.attemptUpdate
を false
に設定します。アプリ
引き続き次の条件を処理します。
条件 | アクション |
---|---|
デバイスが 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 の ユーザーのプライバシー要件。
次のステップ
- ARCore セッションを構成する方法を学習する。