Ahorro de batería de rutina

Android 10 incluye una opción para programar el ahorro de batería llamada según la rutina. Esta opción permite que una app elegida por el OEM haga lo siguiente: proporcionan señales al sistema para una programación más inteligente del ahorro de batería. Esta opción requiere configuración y su implementación es opcional.

Configuración del dispositivo

Especificación del proveedor

Para notificar a la IU de Configuración que el dispositivo está configurado correctamente, usa la superposición de configuración para anular el valor config_batterySaverScheduleProvider con el nombre del paquete de tu app.

Por ejemplo, si deseas que el paquete de la app com.google.android.apps.turbo controle la configuración based on routine, debes establecer este valor de configuración:

<string name="config_batterySaverScheduleProvider" translatable="false">
com.google.android.apps.turbo</string>

Ahora, el teléfono debería mostrar la opción según la rutina. Para verificarlo, compila la imagen, grábala en un teléfono y navega a Configuración > Batería > Ahorro de batería > Programación del ahorro de batería. Debería aparecer la opción Basado en la rutina.

Umbral desactivado de forma predeterminada

El nuevo campo config_dynamicPowerSavingsDefaultDisableThreshold especifica un nivel de batería en el que el sistema desactiva el ahorro de batería, si el programador basado en la rutina lo activó. El valor predeterminado del sistema es del 80%, pero puedes cambiarlo.

Configuración de la app

Permisos

Las APIs necesarias para que la app active el ahorro de batería están protegidas por el permiso android.permission.POWER_SAVER. Este es un permiso de firma o privilegio, por lo que debes otorgarle este permiso a la app que deseas que pueda activar el ahorro de batería en tu privapp-whitelist.

Ejemplo de cómo otorgar el permiso privapp a una app:

<privapp-permissions package="com.google.android.apps.turbo">
   <permission name="android.permission.POWER_SAVER"/>
</privapp-permissions>

Si no otorgas previamente este permiso a la versión de la app en el sistema de la imagen, la app no puede obtener el permiso ni llamar correctamente a las APIs. El el sistema no proporciona comentarios más allá de los errores de permiso habituales, por lo que verificar que puedes llamar a las APIs y observar sus efectos.

Instalación

Para que según la rutina funcione correctamente, debes preinstalar la app en la una imagen del sistema con el permiso necesario. Proporciona POWER_SAVER para una sola app permiso y permitirle controlar las APIs basadas en rutinas. Comportamiento de la función cuando más de una aplicación intenta usar el permiso y las APIs se no compatible y sin especificar.

Activar ahorro de batería

APIs

Si la configuración se realizó correctamente hasta el momento, la app del OEM especificada en la configuración debería poder llamar correctamente al método asociado en PowerManager para activar el ahorro de batería:

public boolean setDynamicPowerSaveHint(boolean powerSaveHint, int disableThreshold)

Si la opción de programación del ahorro de batería basada en la rutina está habilitada y la app llama a este método con un valor true para powerSaveHint, se activa el ahorro de batería. Especifica disableThreshold para que, si la app no pueda comunicarse, el sistema, este sabe en qué porcentaje de batería es seguro encender Ahorro de batería desactivado.

Esta API está sujeta a anulaciones del usuario y a posponer el ahorro de batería de la misma manera que el ahorro de batería automático basado en porcentajes. Consulta la documentación de la API para obtener más información.

Para verificar que las APIs se llamen correctamente, consulta la configuración de consultas global para verificar lo siguiente: cambió el valor de la configuración de copia de seguridad según las llamadas a la API.

Por ejemplo, si el usuario seleccionó el modo de ahorro de batería de rutina y la app está llamando a setDynamicPowerSaveHint(true, 10), la configuración global debería tener estos valores:

automatic_power_save_mode: 1
dynamic_power_savings_disable_threshold: 10
dynamic_power_savings_enabled: 1

Si luego llamas a setDynamicPowerSaveHint(false, 25), los valores deberían ser los siguientes:

automatic_power_save_mode: 1
dynamic_power_savings_disable_threshold: 25
dynamic_power_savings_enabled: 0

Puedes verificar estos valores con este comando adb:

adb shell settings get global <setting-name>

Verificación

No hay una forma automatizada de verificar esta función porque no hay forma de saber qué comportamiento usará un OEM para decidir cuándo activar el modo de ahorro de batería de rutina. Por lo tanto, los OEM son responsables de probar su integración para asegurarse de que de que el comportamiento cumpla con las expectativas. En particular, verifica que el dispositivo pueda realizar las siguientes tareas:

  • El usuario selecciona En función del porcentaje en la IU de la programación del Ahorro de batería. y selecciona 15%. El ahorro de batería debería activarse automáticamente SOLO cuando hasta el 15% de la batería.
  • El usuario selecciona En función de la rutina en la IU de la programación del Ahorro de batería. Cuándo la app llama a la API con true y se activa el ahorro de batería. Además, el ahorro de batería se desactiva automáticamente si el dispositivo se carga hasta el nivel de umbral indicado y se desconecta.
  • El usuario selecciona ninguna en la IU de la programación del ahorro de batería. El Ahorro de batería nunca debería activarse automáticamente.
  • Si la app activa el ahorro de batería y el usuario lo anula manualmente para que se apague nuevamente (con la Configuración rápida, la Configuración, etc.), debería ESTAR APAGADO hasta que el usuario lo vuelva a activar manualmente o conecte el dispositivo.