ARCore 性能叠加层

ARCore 可以显示一个叠加层面板,其中包含应用的性能统计信息(例如 CPU 和内存用量),从而提供系统资源的实时概览。

启用效果叠加层

请按照以下步骤启用效果叠加层。

  1. 在您的应用中打开 AR 体验,以便有正在运行的 ARCore 会话。您的应用必须处于 AR 模式才能接收启用叠加层的广播。AR 相机预览图像应显示在设备屏幕上。

  2. 使用以下 activity 管理器广播命令为您的应用启用性能叠加层。

    # 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. 使用以下 activity 管理器广播命令为您的应用停用性能叠加层。

    # 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% 的功能。