Monitorar o nível de bateria e o estado de carregamento

Quando a frequência das atualizações em segundo plano é alterada para reduzir o efeito dessas atualizações na duração da bateria, é recomendável verificar o nível atual da bateria e o estado de carregamento.

O impacto na duração da bateria devido à execução de atualizações de aplicativos depende do nível da bateria e do estado de carregamento do dispositivo. O impacto da execução de atualizações enquanto o dispositivo está carregando via CA é insignificante e, na maioria dos casos, você pode maximizar a taxa de atualização sempre que o dispositivo está conectado a um carregador de parede. Por outro lado, se o dispositivo estiver descarregando, a redução da taxa de atualização ajudará a prolongar a duração da bateria.

Da mesma forma, é possível verificar o nível de carga da bateria, reduzindo potencialmente a frequência (ou até mesmo interrompendo) as atualizações quando a carga da bateria estiver quase acabando.

Determinar o estado de carregamento atual

Comece determinando o status de carregamento atual. O BatteryManager transmite todos os detalhes da bateria e do carregamento em uma Intent fixa que inclui o status de carregamento.

Por ser uma intent fixa, você não precisa registrar um BroadcastReceiver. Basta chamar registerReceiver transmitindo null como receptor, conforme mostrado no próximo snippet, a intent de status atual da bateria é retornada. Você pode transmitir um objeto BroadcastReceiver real aqui, mas não é necessário, porque abordaremos as atualizações em uma seção posterior.

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);

Você poderá extrair o estado de carregamento atual e, se o dispositivo estiver sendo carregado, saber se isso está sendo feito via USB ou carregador de parede:

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;

Normalmente, é necessário maximizar a taxa de atualizações em segundo plano no caso em que o dispositivo está conectado a um carregador CA, reduzir a taxa se a carga for via USB e diminuir ainda mais se a bateria estiver descarregando.

Monitorar mudanças no estado de carregamento

O status de carregamento pode mudar tão facilmente quanto a conexão de um dispositivo. Por isso, é importante monitorar as mudanças no estado de carregamento e alterar adequadamente a taxa de atualização.

O BatteryManager transmite uma ação sempre que o dispositivo é conectado ou desconectado da fonte de energia. É importante receber esses eventos mesmo que o app não esteja em execução, principalmente porque eles afetam a frequência de inicialização do app para iniciar uma atualização em segundo plano. Registre um BroadcastReceiver no manifesto para detectar os dois eventos, definindo ACTION_POWER_CONNECTED e ACTION_POWER_DISCONNECTED em um filtro de 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>

Determinar o nível atual da bateria

Em alguns casos, também é útil determinar o nível atual da bateria. Você pode reduzir a taxa de atualizações em segundo plano se a carga da bateria estiver abaixo de um determinado nível.

A carga atual da bateria pode ser encontrada extraindo o nível e a escala atual da intent de status da bateria, conforme mostrado aqui:

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;

Reagir a mudanças significativas no nível da bateria

Não é fácil monitorar continuamente o estado da bateria, mas não é preciso fazer isso.

Em geral, o impacto do monitoramento do nível da bateria é maior no que o comportamento normal do app. Por exemplo, registrar um BroadcastReceiver no manifesto para cancelar o trabalho pendente quando a bateria está fraca serve principalmente para descarregar ainda mais a bateria (e, portanto, é impossível desde o Android 8.0). Em vez disso, você pode fornecer restrições ao trabalho que descrevem quando ele precisa ser executado, permitindo que o sistema tome a decisão sem gastar energia para iniciar o app.

Geralmente, é recomendável não executar as atualizações em segundo plano quando a bateria está criticamente baixa. Não importa se seus dados estão atualizados se o smartphone desligar antes que você possa usá-lo. Para fazer isso, use a biblioteca do WorkManager com uma restrição BatteryNotLow para especificar que o trabalho não será executado se a bateria estiver baixa, além de qualquer restrição NetworkType relevante.

Em muitos casos, o ato de carregar um dispositivo coincide com colocá-lo em uma base. Para saber mais, consulte Determinar e monitorar o estado e o tipo de encaixe na base.