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 套件繪製疊加層的權限。這個步驟只需執行一次。返回應用程式前，請找出 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 核心，這個欄位就會顯示 25% 的 CPU 使用率。

效能重疊也會提供個別 ARCore 功能的 CPU 用量細目。這些細目也會以裝置的可用總 CPU 作業時間百分比表示。工作負載包括：

疊加層不會顯示任何停用或 CPU 作業時間低於 0.1% 的地圖項目。