Surveiller l'état de charge et le niveau de la batterie

Lorsque vous modifiez la fréquence des mises à jour en arrière-plan afin de réduire l'effet des mises à jour sur l'autonomie de la batterie, et de vérifier le niveau et l'état de charge actuels de la batterie démarrer.

L'impact des mises à jour des applications sur l'autonomie de la batterie dépend du niveau de la batterie et l'état de charge de l'appareil. Impact des mises à jour effectuées lorsque l'appareil est en charge sur secteur est négligeable. Dans la plupart des cas, vous pouvez donc maximiser la fréquence d'actualisation lorsque l'appareil est connecté à un chargeur mural. À l'inverse, si l'appareil se décharge, réduire la fréquence de mise à jour de prolonger l'autonomie de la batterie.

De même, vous pouvez vérifier le niveau de charge de la batterie, ce qui peut réduire la fréquence des... vos mises à jour lorsque le niveau de charge de la batterie est presque épuisé.

Déterminer l'état de charge actuel

Commencez par déterminer l'état actuel des débits. BatteryManager diffuse tous les détails de la batterie et de la charge dans un élément Intent collant qui inclut l'état de charge.

Comme il s'agit d'un intent persistant, vous n'avez pas besoin d'enregistrer un BroadcastReceiver. Il vous suffit d'appeler registerReceiver et de transmettre null comme récepteur, comme indiqué dans l'extrait suivant, l'intent actuel d'état de la batterie est renvoyé. Vous pouvez transmettre ici un objet BroadcastReceiver réel, mais nous traiterons les mises à jour dans une section ultérieure, ce n'est donc pas nécessaire.

val batteryStatus: Intent? = IntentFilter(Intent.ACTION_BATTERY_CHANGED).let { ifilter ->
    context.registerReceiver(null, ifilter)
}

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

Vous pouvez extraire l'état de charge actuel et, si l'appareil est en charge, déterminer si l'appareil est en charge via USB ou un chargeur:

val status: Int = batteryStatus?.getIntExtra(BatteryManager.EXTRA_STATUS, -1) ?: -1
val isCharging: Boolean = status == BatteryManager.BATTERY_STATUS_CHARGING
        || status == BatteryManager.BATTERY_STATUS_FULL

// How are we charging?
val chargePlug: Int = batteryStatus?.getIntExtra(BatteryManager.EXTRA_PLUGGED, -1) ?: -1
val usbCharge: Boolean = chargePlug == BatteryManager.BATTERY_PLUGGED_USB
val acCharge: Boolean = chargePlug == BatteryManager.BATTERY_PLUGGED_AC

// Are we charging / charged?
int status = batteryStatus.getIntExtra(BatteryManager.EXTRA_STATUS, -1);
boolean isCharging = status == BatteryManager.BATTERY_STATUS_CHARGING ||
                     status == BatteryManager.BATTERY_STATUS_FULL;

// How are we charging?
int chargePlug = batteryStatus.getIntExtra(BatteryManager.EXTRA_PLUGGED, -1);
boolean usbCharge = chargePlug == BatteryManager.BATTERY_PLUGGED_USB;
boolean acCharge = chargePlug == BatteryManager.BATTERY_PLUGGED_AC;

En règle générale, il est recommandé d'optimiser la fréquence des mises à jour en arrière-plan si l'appareil branché à un chargeur secteur, réduisez la vitesse si la recharge est via USB, puis la baissez-la si la batterie se décharge.

Surveiller les changements d'état de charge

L'état de charge peut changer aussi facilement qu'un appareil peut être branché. Il est donc important de surveiller l'état de recharge et modifier la fréquence d'actualisation en conséquence.

BatteryManager diffuse une action chaque fois que l'appareil est connecté ou hors tension. Il est important de recevoir ces événements même lorsque votre application n'est pas en cours d'exécution, d'autant plus que ces événements doivent avoir un impact sur la fréquence à laquelle vous lancez votre application lancer une mise à jour en arrière-plan. Vous devez donc enregistrer un BroadcastReceiver dans votre fichier manifeste pour écouter les deux événements en définissant ACTION_POWER_CONNECTED et ACTION_POWER_DISCONNECTED dans un filtre d'intent.

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

Déterminer le niveau actuel de la batterie

Dans certains cas, il est également utile de déterminer le niveau actuel de la batterie. Vous pouvez choisir de réduire la fréquence des mises à jour en arrière-plan si la charge de la batterie est inférieure à un certain niveau.

Vous pouvez déterminer la charge actuelle de la batterie en extrayant le niveau actuel de la batterie et la balance depuis l'intent d'état de la batterie, comme indiqué ici:

val batteryPct: Float? = batteryStatus?.let { intent ->
    val level: Int = intent.getIntExtra(BatteryManager.EXTRA_LEVEL, -1)
    val scale: Int = intent.getIntExtra(BatteryManager.EXTRA_SCALE, -1)
    level * 100 / scale.toFloat()
}

int level = batteryStatus.getIntExtra(BatteryManager.EXTRA_LEVEL, -1);
int scale = batteryStatus.getIntExtra(BatteryManager.EXTRA_SCALE, -1);

float batteryPct = level * 100 / (float)scale;

Réagir à des changements significatifs du niveau de la batterie

Vous ne pouvez pas surveiller facilement l'état de la batterie, mais ce n'est pas nécessaire.

De manière générale, la surveillance du niveau de la batterie a un impact sur la batterie que le comportement normal de votre application. Par exemple, l'enregistrement d'un BroadcastReceiver dans le fichier manifeste pour annuler le travail en attente lorsque la batterie est faible servent principalement à décharger la batterie impossible, Android 8.0). Au lieu de cela, vous pouvez fournir des contraintes sur le travail qui décrivent le moment où il doit être exécuté, en permettant au système de prendre une décision sans dépenser le temps de démarrage de votre application.

Il est généralement recommandé de ne pas exécuter les mises à jour en arrière-plan lorsque la batterie très faibles. Peu importe la fraîcheur de vos données si le téléphone s'éteint avant que vous pouvez les utiliser. Pour ce faire, Utiliser la bibliothèque WorkManager avec un Contrainte BatteryNotLow pour spécifier que la tâche ne doit pas être exécutée si la batterie est faible (en plus des NetworkType).

Dans de nombreux cas, le fait de charger un appareil revient à le placer sur une station d'accueil. La prochaine Déterminer l'état actuel de la station d'accueil et surveiller les changements d'appareil sur la station d'accueil.