ARCore のパフォーマンス オーバーレイ

ARCore では、CPU やメモリの使用状況などのアプリのパフォーマンス統計情報をオーバーレイ パネルに表示して、システム リソースの概要をリアルタイムで確認できます。

パフォーマンス オーバーレイを有効にする

パフォーマンス オーバーレイを有効にする手順は次のとおりです。

  1. アプリで AR エクスペリエンスを開き、アクティブな ARCore セッションが実行されているようにします。オーバーレイを有効にするブロードキャストを受信するには、アプリが AR モードになっている必要があります。AR カメラのプレビュー画像がデバイスの画面に表示されます。

  2. アプリのパフォーマンス オーバーレイを有効にするには、次のアクティビティ マネージャーのブロードキャスト コマンドを使用します。

    # Enables ARCore's performance overlay and saves a setting to your app's
# Android Shared Preferences, so that the overlay remains enabled in
# subsequent ARCore sessions.

# Your app must have an actively running ARCore session to receive the broadcast.
adb shell am broadcast -a com.google.ar.core.ENABLE_PERFORMANCE_OVERLAY

  3. Settings メニューが表示され、ARCore パッケージにオーバーレイを描画する権限を付与できます。この手順は 1 回だけ行います。アプリに戻る前に、Google Play Services for AR を探し、権限の切り替えを Allowed に設定します。

    ARCore にオーバーレイを描画する権限を付与せずにパフォーマンス オーバーレイを有効にした場合は、アプリで新しい ARCore セッションを開始するたびに、設定メニューが表示されます。この場合は、ARCore 権限を付与するか、パフォーマンス オーバーレイを無効にする必要があります。

パフォーマンス オーバーレイを無効にする

パフォーマンス オーバーレイを無効にする手順は次のとおりです。

  1. アプリで AR エクスペリエンスを開き、アクティブな ARCore セッションが実行されているようにします。オーバーレイを無効にするブロードキャストを受信するには、アプリが AR モードになっている必要があります。AR カメラのプレビュー画像がデバイスの画面に表示されます。

  2. アプリのパフォーマンス オーバーレイを無効にするには、次のアクティビティ マネージャーのブロードキャスト コマンドを使用します。

    # Disables ARCore's performance overlay and saves a setting to your app's
# Android Shared Preferences, so that the overlay remains disabled in
# subsequent ARCore sessions.

# Your app must have an actively running ARCore session to receive the broadcast.
adb shell am broadcast -a com.google.ar.core.DISABLE_PERFORMANCE_OVERLAY

パフォーマンス オーバーレイを無効にすることもできます。そのためには、オーバーレイの閉じるボタン をタップし、アプリの Android 共有環境設定を消去します。アプリのデータを消去する方法があります。

CPU 使用率の値の解釈

Process CPU Usage フィールドには、アプリプロセスが現在使用している CPU 時間が、デバイスで使用可能な CPU 時間の合計に対する割合として表示されます。この値には、アプリケーション ワークロード、ARCore ワークロード、アプリで使用するその他のライブラリが含まれます。たとえば、クアッドコア デバイスで実行しているときにアプリプロセスが単一の CPU コアを完全に飽和状態とした場合、このフィールドには CPU 使用率が 25% と表示されます。

パフォーマンス オーバーレイには、個々の ARCore 機能の CPU 使用率の内訳も表示されます。こうした内訳は、デバイスで使用可能な CPU 時間の合計に対する割合としても表されます。ワークロードは次のとおりです。

無効になっている機能や 0.1% 未満の CPU 時間を使用している機能は、オーバーレイに表示されません。