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 開発者サービスがインストールされます。 | このアプリでは ArCoreApk_requestInstall() を使用して ARCore をダウンロードしてインストールしています。 |
Android minSdkVersion の要件 |
Android 7.0(API レベル 24) | Android 7.0(API レベル 24) |
ARCore のサポートとインストール ステータスを確認するには、ArCoreApk_checkAvailability() または ArCoreApk_checkAvailabilityAsync() を使用する必要があります |
||
AR 用 Google Play 開発者サービスをインストールするには、ArCoreApk_requestInstall() を使用する必要があります |
アプリを AR 必須または AR オプションにするには、AndroidManifest.xml
を更新して以下のエントリを追加します。
AR が必要
<uses-permission android:name="android.permission.CAMERA" />
<!-- Limits app visibility in the Google Play Store to ARCore supported devices
(https://developers.google.com/ar/devices). -->
<uses-feature android:name="android.hardware.camera.ar" />
<application …>
…
<!-- "AR Required" app, requires "Google Play Services for AR" (ARCore)
to be installed, as the app does not include any non-AR features. -->
<meta-data android:name="com.google.ar.core" android:value="required" />
</application>
AR(オプション)
<uses-permission android:name="android.permission.CAMERA" />
<!-- If your app was previously AR Required, don't forget to remove the
`<uses-feature android:name="android.hardware.camera.ar" />` entry, as
this would limit app visibility in the Google Play Store to only
ARCore supported devices. -->
<application …>
…
<!-- "AR Optional" app, contains non-AR features that can be used when
"Google Play Services for AR" (ARCore) is not available. -->
<meta-data android:name="com.google.ar.core" android:value="optional" />
</application>
次に、アプリの build.gradle
を変更して、24
以上の minSdkVersion
を指定します。
android {
defaultConfig {
…
minSdkVersion 24
}
}
ビルド依存関係を追加する
プロジェクトの
build.gradle
ファイルに Google の Maven リポジトリが含まれていることを確認します。allprojects { repositories { google() … } }
モジュールの
build.gradle
ファイルにカスタムタスクを追加して、ARCore の AAR ファイルからインクルードされたネイティブ ライブラリを抽出します。こうすることで、C または C++ プロジェクトで直接参照できます。app/build
ディレクトリで、ネイティブ ライブラリを抽出するディレクトリへの変数を定義します。データと抽出タスクを保持する Gradle 構成を作成します。
/* The ARCore AAR library contains native shared libraries that are extracted before building to a temporary directory. */ def arcore_libpath = "${buildDir}/arcore-native" // Create a configuration to mark which aars to extract .so files from configurations { natives }
AAR ファイルからネイティブ ライブラリをコピーするタスクを作成し、ビルド依存関係に追加します。
// Extracts the shared libraries from AARs in the native configuration // so that NDK builds can access these libraries. task extractNativeLibraries() { // Extract every time. outputs.upToDateWhen { false } doFirst { configurations.natives.files.each { f -> copy { from zipTree(f) into arcore_libpath include "jni/**/*" } } } } tasks.whenTaskAdded { task-> if (task.name.contains("external") && !task.name.contains("Clean")) { task.dependsOn(extractNativeLibraries) } }
そのロケーションを外部ビルドツールに渡すように、ネイティブ ビルドフラグを構成します。
// From the sample app. externalNativeBuild { cmake { cppFlags "-std=c++11", "-Wall" arguments "-DANDROID_STL=c++_static", "-DARCORE_LIBPATH=${arcore_libpath}/jni", "-DARCORE_INCLUDE=${project.rootDir}/../../libraries/include" } }
Java ライブラリとネイティブ ライブラリの両方の依存関係を追加します。
dependencies { ... // Add Java and native dependencies to the ARCore library. implementation 'com.google.ar:core:1.33.0' natives 'com.google.ar:core:1.33.0' ... }
CMakeLists.txt
でネイティブ ライブラリを参照します。# Import the ARCore library. add_library(arcore SHARED IMPORTED) set_target_properties(arcore PROPERTIES IMPORTED_LOCATION ${ARCORE_LIBPATH}/${ANDROID_ABI}/libarcore_sdk_c.so INTERFACE_INCLUDE_DIRECTORIES ${ARCORE_INCLUDE} )
ランタイム チェックを実行する
アプリの AR 機能がスムーズに動作するように、実行時に次のことを行います。
ARCore がサポートされているかどうかを確認する
AR 必須アプリと AR オプションアプリの両方で、ArCoreApk_checkAvailability()
または ArCoreApk_checkAvailabilityAsync()
を使用して、現在のデバイスが ARCore をサポートしているかどうかを判断する必要があります。ARCore をサポートしていないデバイスでは、AR 関連の機能を無効にして、関連する UI 要素を非表示にする必要があります。
Android NDK アプリでは、Java ArCoreApk
クラスを使用して、ネイティブ C ARCore Session API で互換性を確認し、インストールを管理できます。アプリの構造によっては、エラー処理やユーザー インターフェースの操作が大量に関係するため、この方法のほうが ArCoreApk_
関数を使用するよりも簡単なことがあります。
void maybeEnableArButton(JNIEnv env, jobject context) {
// Likely called from Activity.onCreate() of an activity with AR buttons.
ArAvailability availability
ArCoreApk_checkAvailability(env, context, &availability);
if (availability == AR_AVAILABILITY_UNKNOWN_CHECKING) {
// Set a timer to call maybeEnableArButton() again after about 200ms.
}
if (availability == AR_AVAILABILITY_SUPPORTED_NOT_INSTALLED ||
availability == AR_AVAILABILITY_SUPPORTED_APK_TOO_OLD ||
availability == AR_AVAILABILITY_SUPPORTED_INSTALLED) {
// Show or enable the AR button.
} else {
// Hide or disable the AR button.
}
}
Google Play 開発者サービス(AR)が AR 必須アプリと一緒にインストールされていても、サポートされていないデバイスを使用するユーザーが外部ソースからインストールする可能性があります。ArCoreApk_checkAvailability()
または ArCoreApk_checkAvailabilityAsync()
を使用して ARCore のサポート状況を確認すると、一貫したエクスペリエンスが保証されます。
ArCoreApk_checkAvailability()
は、デバイスが ARCore をサポートしているかどうかを判断するために、ネットワーク リソースをクエリする必要がある場合があります。この間は AR_AVAILABILITY_UNKNOWN_CHECKING
が返されます。認識されるレイテンシとポップインを減らすため、アプリはライフサイクルの早い段階で ArCoreApk_checkAvailability()
を呼び出してクエリを開始し、戻り値を無視する必要があります。これにより、AR 入力 UI 要素が表示される可能性があるときに、キャッシュに保存された結果をすぐに利用できるようになります。
Google Play 開発者サービス(AR)がインストールされているかどうかを確認する
AR 必須アプリと AR オプションのアプリは、ARCore セッションを作成する前に ArCoreApk_requestInstall()
を呼び出して、互換性のあるバージョンの Google Play 開発者サービス(AR)が(まだ)インストールされていることを確認し、必要な ARCore デバイス プロファイル データがすべてダウンロードされていることを確認する必要があります。
// Tracks if an installation request has already been triggered.
bool install_requested_;
void nativeOnCreate() {
// Do other setup here.
install_requested_ = false;
}
void nativeOnResume(JNIEnv env, jobject activity) {
if (ar_session_ == null) {
bool user_requested_install = !install_requested_;
ArInstallStatus install_status;
// Ensure that Google Play Services for AR and ARCore device profile data are
// installed and up to date.
ArStatus error = ArCoreApk_requestInstall(
env, activity, user_requested_install, &install_status);
if (error != AR_SUCCESS) {
// Inform user of error.
return;
}
switch (install_status) {
case AR_INSTALL_STATUS_INSTALLED:
break;
case AR_INSTALL_STATUS_INSTALL_REQUESTED:
// When this method returns AR_INSTALL_STATUS_INSTALL_REQUESTED:
// 1. This activity will be paused.
// 2. The user is prompted to install or update Google Play
// Services for AR (market://details?id=com.google.ar.core).
// 3. ARCore downloads the latest device profile data.
// 4. This activity is resumed. The next invocation of
// ArCoreApk_requestInstall() will either return
// AR_INSTALL_STATUS_INSTALLED or throw an exception if the
// installation or update did not succeed.
install_requested_ = true;
return;
}
// Request camera permissions.
error = ArSession_create(env, context, &ar_session_);
if (error != AR_SUCCESS) {
// Inform user of error.
return;
}
// Configure the ARCore session.
}
// Normal onResume behavior.
}
ユーザーのプライバシー要件を遵守する
Play ストアでアプリを公開するには、アプリが ARCore のユーザー プライバシー要件を遵守していることをご確認ください。
次のステップ
- ARCore セッションを構成する方法をご確認ください。