Android 10 incluye una opción de programación de ahorro de batería llamada en función de la rutina. Esta opción permite que una app elegida por el OEM proporcione señales al sistema para lograr 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 una rutina.
Umbral de desactivación predeterminado
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 este permiso de forma previa a la versión de la app en la imagen del sistema, la app no puede adquirir el permiso ni llamar a las APIs de forma correcta. El sistema no proporciona ningún comentario más allá de los errores de permisos habituales, por lo que debes verificar que puedas llamar a las APIs y observar sus efectos.
Instalación
Para que la opción Basada en rutina funcione correctamente, debes preinstalar la app en la imagen del sistema con el permiso requerido. Otórgale el permiso POWER_SAVER a una sola app y permítele controlar las APIs basadas en rutinas. El comportamiento de la función cuando más de una app intenta usar el permiso y las APIs no se admite ni especifica.
Activa el 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 puede comunicarse con el sistema, este aún sepa en qué porcentaje de batería es seguro desactivar el ahorro de batería.
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 se llame a las APIs correctamente, consulta la configuración global para verificar que el parámetro de configuración de copia de seguridad haya cambiado de valor 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 llama 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 el siguiente 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 el comportamiento cumpla con las expectativas. En particular, verifica que el dispositivo pueda realizar las siguientes tareas:
- El usuario selecciona según el porcentaje en la IU de la programación del ahorro de batería y elige el 15%. El Ahorro de batería debería activarse automáticamente SOLO cuando llegue al 15% de batería.
- El usuario selecciona en función de la rutina en la IU de la programación del ahorro de batería. Cuando la app llama a la API con
true, 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 ninguno en la IU de 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.), este DEBE ESTAR APAGADO hasta que el usuario lo vuelva a activar manualmente o conecte el dispositivo.