Déterminer l'état de la batterie

Introduction

Suivant votre application, il peut s'avérer important de vérifier l'état de la batterie avant de lancer certains traitements qui peuvent être gourmands en énergie électrique:

- Prise de photos ou pire de vidéos

- Mise à jour demandant des accès au réseau wifi ou 3g, 4g, ...

- Flash...

Bref tout ce qui peut être énergivore !

Changement d'état de la batterie

Une première solution pour connaître l'état de la batterie est d'utiliser le broadcast ACTION_BATTERY_CHANGED. Cette solution permettra d'avoir des informations détaillées sur la batterie.

Le broadcast utilisé est particulier, car il s'agit d'une sticky intent, c'est à dire d'une intention dont le résultat est toujours disponible. Il n'est donc pas nécessaire d'enregistrer un BroadcastReceiver.

De ce fait, il n'existe pas de android.intent.action.BATTERY_CHANGED. Vous ne pouvez donc pas vous enregistrer à ce broadcast depuis le fichier AndroidManifest.xml !

IntentFilter ifilter = new IntentFilter(Intent.ACTION_BATTERY_CHANGED); Intent batteryStatus = context.registerReceiver(null, ifilter);

Ce broadcast retourne les informations suivantes de l'intention dans l'extra data.

Ces informations (constantes, chaînes de caractères) sont codées dans la classe BatteryManager.

Voici les informations supplémentaires disponibles sur une batterie:

Cf. extra data d'une intention.

Batterie en charge ou chargée

Vous trouverez souvent ce genre de code pour savoir rapidement si la batterie est chargée ou en charge:

int status = batteryStatus.getIntExtra(BatteryManager.EXTRA_STATUS, -1); boolean isCharging = status == BatteryManager.BATTERY_STATUS_CHARGING || status == BatteryManager.BATTERY_STATUS_FULL;

C'est un première réponse possible pour savoir si vous pouvez ou non effectruer un traitement consommateur d'énergie...

Etat de charge

Etat de santé

Type de charge

Une valeur particulière:0, la batterie n'est pas en charge...

L'icone de charge de la batterie

A priori, vous ferez vous même vos images, mais si vous en avez vraiment besoin...

Vous pouvez afficher l'icone représentant le niveau de charge de la batterie (où le résultat dépendra des appareils):

ImageView imageView=(ImageView)findViewById(R.id.imageView1); IntentFilter batIntentFilter = new IntentFilter(Intent.ACTION_BATTERY_CHANGED); Intent battery = registerReceiver(null, batIntentFilter); int ressourceId = battery.getIntExtra(BatteryManager.EXTRA_ICON_SMALL, -1); Log.d ("MainActivity", "Ressource ID Batterie:" + ressourceId); imageView.setImageResource(ressourceId);

Et pour rappel, l'objet ImageView.

Autres états

D'autres informations sur l'état de la batterie seront disponibles avec le broadcast ACTION_BATTERY_CHANGED dans les versions suivantes d'Android:

http://developer.android.com/reference/android/os/BatteryManager.html

Exemple de code

package fr.free.supertos; import android.app.Activity; import android.content.Intent; import android.content.IntentFilter; import android.os.BatteryManager; import android.os.Bundle; import android.util.Log; public class MainActivity extends Activity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); IntentFilter batIntentFilter = new IntentFilter(Intent.ACTION_BATTERY_CHANGED); Intent battery = registerReceiver(null, batIntentFilter); int status = battery.getIntExtra(BatteryManager.EXTRA_STATUS, -1); int voltage = battery.getIntExtra(BatteryManager.EXTRA_VOLTAGE, -1); int temperature = battery.getIntExtra(BatteryManager.EXTRA_TEMPERATURE, -1); int niveau = battery.getIntExtra(BatteryManager.EXTRA_LEVEL, -1); int maxNiveau = battery.getIntExtra(BatteryManager.EXTRA_SCALE, -1); boolean presente = battery.getBooleanExtra(BatteryManager.EXTRA_PRESENT, false); int statusBat = battery.getIntExtra(BatteryManager.EXTRA_STATUS, -1); String statusBatterie=""; switch (statusBat) { case BatteryManager.BATTERY_STATUS_CHARGING: statusBatterie="CHARGEE"; break; case BatteryManager.BATTERY_STATUS_DISCHARGING: statusBatterie="DECHARGEE"; break; case BatteryManager.BATTERY_STATUS_FULL: statusBatterie="FULL"; break; case BatteryManager.BATTERY_STATUS_NOT_CHARGING: statusBatterie="NON CHARGEE"; break; case BatteryManager.BATTERY_STATUS_UNKNOWN: statusBatterie="status inconnu"; break; default: statusBatterie="code inconnu"; break; } int plug = battery.getIntExtra(BatteryManager.EXTRA_PLUGGED, -1); String plugBatterie=""; switch (plug) { case BatteryManager.BATTERY_PLUGGED_AC: plugBatterie="en charge sur secteur"; break; case BatteryManager.BATTERY_PLUGGED_USB: plugBatterie="en charge via USB"; break; case BatteryManager.BATTERY_PLUGGED_WIRELESS: plugBatterie="en charge WIRELESS"; break; default: plugBatterie="code charge inconnu"; break; } int health = battery.getIntExtra(BatteryManager.EXTRA_HEALTH, -1); String healthBatterie=""; switch (plug) { case BatteryManager.BATTERY_HEALTH_COLD: healthBatterie="froide"; break; case BatteryManager.BATTERY_HEALTH_DEAD: healthBatterie="morte"; break; case BatteryManager.BATTERY_HEALTH_GOOD: healthBatterie="bonne"; break; case BatteryManager.BATTERY_HEALTH_OVERHEAT: healthBatterie="surchauffe"; break; case BatteryManager.BATTERY_HEALTH_OVER_VOLTAGE: healthBatterie="surcharge"; break; case BatteryManager.BATTERY_HEALTH_UNKNOWN: healthBatterie="état de santé indéterminé"; break; case BatteryManager.BATTERY_HEALTH_UNSPECIFIED_FAILURE: healthBatterie="incident indéterminé"; break; default: healthBatterie="code santé inconnu"; break; } String techno = battery.getStringExtra(BatteryManager.EXTRA_TECHNOLOGY); float tempFloat = ((float) temperature) / 10; Log.d ("BATTERIE", "Batterie " + (presente==true?"PRESENTE":"ABSENTE") + ", voltage:" + voltage + "mV" + ", techno:" + techno + ", Batterie " + statusBatterie + ", temperature:" + tempFloat + "°C, niveau de charge: " + niveau + " sur " + maxNiveau + " " + plugBatterie + ", Etat de santé:" + healthBatterie ); } }

Simple code affichant dans une log les différentes informations sur l'état de la batterie.

Etre informé de certaines modifications de l'état de la batterie

La seconde solution consiste à être informé de façon plus précise sur certaines modifications de l'état de la batterie:

Actuellement, les changements d'état se feront sur la batterie en charge ou non, le niveau bas de la charge de la batterie, ou niveau ok suite à une information de niveau bas.

Depuis votre code, vous pouvez vous enregistrer avec:

String ACTION_POWER_CONNECTED: l'appareil est connecté à une source d'énergie externe.
String ACTION_POWER_DISCONNECTED: L'appareil est de la source d'énergie externe.

String ACTION_BATTERY_LOW Broadcast Action: La batterie à un niveau de charge qui est faible (déclenché autour de 15% de charge).
String ACTION_BATTERY_OKAY Broadcast Action: La batterie est repassée à un niveau de charge correcte (après être passée à un niveau faible, autour de 20%).

Ou l'équivalent si vous enregistrez votre broadcast receiver depuis le fichier AndroidManifest.xml:

android.intent.action.ACTION_POWER_CONNECTED

android.intent.action.ACTION_POWER_DISCONNECTED

android.intent.action.BATTERY_LOW

android.intent.action.BATTERY_OKAY

Evidement, il s'agit de broadcasts qui seront envoyés. Mais contrairement à ACTION_BATTERY_CHANGED qui est en fait un sticky intent, ici, il s'agira de broadcast intent. Il faudra donc développer des broadcast receivers.

Il n'y a pas de permission particulière à poser pour recevoir ces infomations du système.

Exemple

Premier exemple:

Voici un exemple de code pour savoir quand l'appareil est connecté/déconnecté à une source externe d'énergie:

Le code du broadcast receiver pour les messages ACTION_POWER_CONNECTED et ACTION_POWER_DISCONNECTED

package fr.free.supertos; import android.content.BroadcastReceiver; import android.content.Context; import android.content.Intent; import android.widget.Toast; public class PowerBatterieReceiver extends BroadcastReceiver { @Override public void onReceive(Context context, Intent intent) { String etat; if (intent.getAction().equals(Intent.ACTION_POWER_CONNECTED)) { etat="Connecté à une source d'énergie externe..."; } else { etat="Déconnecté de la source d'énergie externe..."; } CharSequence cs=etat; Toast toast = Toast.makeText(context, cs, Toast.LENGTH_LONG); toast.show(); } }

Récupération de l'action sur l'intention pour déterminer s'il s'agit d'une connexion ou d'une déconnexion.

Puis la partie qu'il faut ajouter dans la section application du AndroidManifest.xml pour s'abonner aux messages:

<receiver android:name="PowerBatterieReceiver"> <intent-filter> <action android:name="android.intent.action.ACTION_POWER_CONNECTED"/> <action android:name="android.intent.action.ACTION_POWER_DISCONNECTED"/> </intent-filter> </receiver>

Voilà, un beau Toast s'affichera lorsque vous brancherez ou débrancherez votre appareil d'une source externe !

Second exemple:

L'équivalent pour le niveau de la batterie

package fr.free.supertos; import android.content.BroadcastReceiver; import android.content.Context; import android.content.Intent; import android.widget.Toast; public class PowerBatterieReceiver extends BroadcastReceiver { @Override public void onReceive(Context context, Intent intent) { String etat; if (intent.getAction().equals(Intent.ACTION_POWER_CONNECTED)) { etat="Connecté à une source d'énergie externe..."; } else { etat="Déconnecté de la source d'énergie externe..."; } CharSequence cs=etat; Toast toast = Toast.makeText(context, cs, Toast.LENGTH_LONG); toast.show(); } }

Et la section à ajouter dans AndroidManifest.xml sous la section application

<receiver android:name="LevelBatterieReceiver"> <intent-filter> <action android:name="android.intent.action.BATTERY_LOW"/> <action android:name="android.intent.action.BATTERY_OKAY"/> </intent-filter> </receiver>

Cette fois-ci, l'affichage de l'information se fera à l'aide de notifications.