Superposición de rendimiento de ARCore

ARCore puede mostrar un panel superpuesto con las estadísticas de rendimiento de una app, como el uso de CPU y memoria, lo que proporciona una descripción general en tiempo real de los recursos del sistema.

Cómo habilitar la superposición de rendimiento

Sigue estos pasos para habilitar la superposición de rendimiento.

  1. Abre la experiencia de RA en tu app para que haya una sesión activa de ARCore en ejecución. Tu app debe estar en modo de RA para recibir la transmisión que habilita la superposición. Las imágenes de vista previa de la cámara de RA deben estar visibles en la pantalla del dispositivo.

  2. Usa el siguiente comando de emisión del administrador de actividades para habilitar la superposición de rendimiento en tu app.

    # 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. Es posible que se te dirija al menú Settings a fin de otorgar permiso al paquete de ARCore para dibujar superposiciones. Este paso solo se debe realizar una vez. Busca Google Play Services for AR y establece el botón de activación de permisos en Allowed antes de volver a tu app.

    Si habilitaste la superposición de rendimiento sin otorgar permiso de ARCore para dibujar superposiciones, se te redireccionará al menú Configuración cada vez que la app inicie una nueva sesión de ARCore. En este caso, debes otorgar permiso de ARCore o inhabilitar la superposición de rendimiento.

Cómo inhabilitar la superposición de rendimiento

Sigue estos pasos para inhabilitar la superposición de rendimiento.

  1. Abre la experiencia de RA en tu app para que haya una sesión activa de ARCore en ejecución. Tu app debe estar en modo de RA para recibir la transmisión que inhabilita la superposición. Las imágenes de vista previa de la cámara de RA deben estar visibles en la pantalla del dispositivo.

  2. Usa el siguiente comando de emisión del administrador de actividades para inhabilitar la superposición de rendimiento de tu app.

    # 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

También puedes inhabilitar la superposición de rendimiento si presionas el botón para cerrar en la superposición y borras las preferencias compartidas de Android de tu app. Una forma de hacerlo es borrar los datos de la app.

Interpreta los valores de uso de la CPU

El campo Process CPU Usage muestra la cantidad de tiempo de CPU que el proceso de la aplicación usa actualmente como un porcentaje del tiempo de CPU total disponible del dispositivo. Este valor incluye las cargas de trabajo de la aplicación, las cargas de trabajo de ARCore y cualquier otra biblioteca que use tu app. Por ejemplo, el campo mostrará el 25% del uso de CPU si el proceso de la aplicación satura por completo un solo núcleo de CPU cuando se ejecuta en un dispositivo con cuatro núcleos.

La superposición de rendimiento también proporciona un desglose del uso de CPU de las funciones individuales de ARCore. Estos desgloses también se expresan como un porcentaje del tiempo de CPU total disponible del dispositivo. Las cargas de trabajo son las siguientes:

La superposición no muestra funciones que estén inhabilitadas o que usen menos del 0.1% de tiempo de CPU.