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 em CA é insignificante. Portanto, 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 das atualizações (ou até mesmo interrompendo) 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.

Como essa é uma intent fixa, você não precisa registrar um BroadcastReceiver. Basta chamar registerReceiver transmitindo null como o receptor, conforme mostrado no próximo snippet, para que a intent de status atual da bateria seja retornada. Você pode transmitir um objeto BroadcastReceiver real aqui, mas isso 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);

É possível extrair o status de carregamento atual e, se o dispositivo estiver sendo carregado, saber se ele está sendo carregado 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 quando o dispositivo está conectado a um carregador de parede, 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 a taxa de atualização.

O BatteryManager transmite uma ação sempre que o dispositivo é conectado ou desconectado da energia. É importante receber esses eventos mesmo que o app não esteja em execução, principalmente porque eles afetam a frequência com que você o inicia para iniciar uma atualização em segundo plano. Portanto, 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ê poderá optar por reduzir a taxa das 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 atuais 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.

De modo geral, o impacto do monitoramento do nível da bateria tem um impacto maior na bateria do que o comportamento normal do app. Por exemplo, o registro de 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, é possível fornecer restrições ao trabalho que descrevem quando ele precisa ser executado, permitindo que o sistema tome a decisão sem gastar energia ao iniciar o app.

Em geral, é 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 precisa ser executado se a bateria estiver baixa (além de quaisquer restrições NetworkType relevantes).

Em muitos casos, o ato de carregar um dispositivo coincide com colocá-lo em uma base. A próxima lição mostra como determinar o estado atual da base e monitorar as mudanças na ancoragem do dispositivo.