Esta página describe cómo Android maneja los productos que tienen baterías extraíbles o no tienen baterías internas. En cambio, estos últimos dispositivos están conectados a una fuente de alimentación externa, como una toma de corriente de CA o un puerto USB de otro dispositivo.
¿Hay una batería presente?
Las aplicaciones pueden utilizar el siguiente código para detectar si el dispositivo tiene batería actualmente presente:
```
final Intent batteryInfo = registerReceiver(null, new
IntentFilter(Intent.ACTION_BATTERY_CHANGED));
return batteryInfo.getBooleanExtra(BatteryManager.EXTRA_PRESENT, true);
```
Comportamiento del dispositivo sin batería
Si Android no detecta un dispositivo con batería para su producto, se utilizan los siguientes valores predeterminados relacionados con la batería. Tenga en cuenta que los valores predeterminados han cambiado en la versión de Android 9. Esta tabla muestra las diferencias.
| Estado de la batería | Android 9 y superior | Android 8.1 y anteriores |
|---|---|---|
| Presente | FALSO | verdadero |
| Estado | desconocido | cargando |
| Capacidad restante | 0 | 100% |
| Salud | desconocido | bien |
| Estado en línea del cargador de CA | no modificado | forzado a ser verdad |
Los fabricantes pueden modificar la configuración predeterminada utilizando un controlador power_supply del kernel o Health HAL .
Android 9 y superior
Android 9 elimina algunos códigos anteriores para dispositivos sin batería que, de forma predeterminada, simulaban que había una batería presente, que se estaba cargando al 100 % y que estaban en buen estado con una lectura de temperatura normal en su termistor.
La mayoría de las API de marco que se ocupan de esta información continúan manejando situaciones comunes igual que antes: se considerará que el sistema se está cargando (es decir, que no funciona con batería) y no se considerará que tiene batería baja. Si la interfaz de usuario muestra el ícono de la batería, aparecerá con un signo de exclamación y el porcentaje de batería se mostrará como 0%. Pero el dispositivo no se apagará por falta de batería, y se programarán trabajos que requieran carga o buena batería.
Android 8.1 y anteriores
Debido a que se desconoce el estado de la batería, las API del marco de trabajo de Android considerarán que el sistema se está cargando (o que no funciona con batería) y no se considerará que tenga batería baja. Si la interfaz de usuario muestra el ícono de la batería, aparecerá con un signo de exclamación y el porcentaje de batería se mostrará como 0%. Pero el dispositivo no se apagará por falta de batería, y se programarán trabajos que requieran carga o buena batería.
Implementación
El código predeterminado de Android 9 puede funcionar correctamente para su dispositivo, pero se recomienda realizar un cambio de kernel o HAL para reflejar con precisión la energía y el estado de la batería de su producto, como se describe anteriormente. Si Android 9 y versiones posteriores no detectan un dispositivo cargador de clase de fuente de alimentación de Linux , entonces, de forma predeterminada, todos los tipos de cargador (CA, USB, inalámbrico) tendrán estado fuera de línea . Si todos los cargadores están fuera de línea pero no se detecta ningún dispositivo con batería, se considerará que el sistema se está cargando en el sentido de que está funcionando con energía externa, no con batería, como se describió anteriormente.
Si su producto no tiene batería y siempre está conectado a una fuente de alimentación, es mejor implementar un controlador de cargador de clase power_supply del kernel de Linux para la fuente de alimentación de CA o USB que establezca su atributo sysfs en línea en true . O puede configurar la propiedad en línea del cargador de CA en un Health HAL para su dispositivo. Para hacer esto, implemente un Health HAL como se describe en Implementación de Health 2.0 .
Este Health HAL personalizado implementa una versión personalizada de Health::getHealthInfo() que modifica el valor de BatteryProperties.chargerAcOnline = true .
Para comenzar, copie el archivo hardware/interfaces/health/2.0/default/Health.cpp a su propia implementación de Health HAL y modifíquelo de acuerdo con el archivo README de Health 2.0 .