Economia de bateria de rotina

O Android 10 apresenta uma opção de programação para economia de bateria chamada baseada em rotina. Essa opção permite que um app escolhido pelo OEM forneça sinais ao sistema para programar uma economia de bateria mais inteligente. Essa opção requer uma configuração, e a implementação dela é opcional.

Configuração do dispositivo

Especificação do provedor

Para notificar a interface de configurações de que o dispositivo está configurado corretamente, use a sobreposição de configuração para substituir o valor config_batterySaverScheduleProvider pelo nome do pacote do app.

Por exemplo, se você quiser que o pacote de apps com.google.android.apps.turbo controle a configuração com base na rotina, defina este valor de configuração:

<string name="config_batterySaverScheduleProvider" translatable="false">
com.google.android.apps.turbo</string>

Agora o smartphone vai mostrar a opção com base na rotina. Para verificar, crie sua imagem, faça a instalação em um smartphone e navegue até Configurações > Bateria > Economia de bateria > Programação da economia de bateria. A opção com base na rotina vai aparecer.

Limite padrão de desativação

O novo campo config_dynamicPowerSavingsDefaultDisableThreshold especifica um nível de bateria em que o sistema desativa o modo de economia de bateria, se ele tiver sido ativado pelo programador baseado em rotina. O padrão do sistema é 80%, mas você pode mudar isso.

Configuração do app

Permissões

As APIs necessárias para que o app ative o modo de economia de bateria são protegidas pela permissão android.permission.POWER_SAVER. Essa é uma permissão de assinatura/privilegiada. Portanto, conceda essa permissão ao app que você quer que acione o modo de economia de bateria na privapp-whitelist.

Exemplo de concessão da permissão privapp a um app:

<privapp-permissions package="com.google.android.apps.turbo">
   <permission name="android.permission.POWER_SAVER"/>
</privapp-permissions>

Se você não conceder essa permissão previamente à versão do app na imagem do sistema, o app não poderá adquirir a permissão nem chamar as APIs corretamente. O sistema não fornece nenhum feedback além dos erros de permissão usuais. Portanto, verifique se você pode chamar as APIs e observe os efeitos delas.

Instalação

Para que a baseada em rotina funcione corretamente, pré-instale o app na imagem do sistema com a permissão necessária. Conceda a permissão POWER_SAVER a apenas um app e permita que ele controle as APIs com base na rotina. O comportamento do recurso quando mais de um app tenta usar a permissão e as APIs não é compatível e não é especificado.

Acionar a Economia de bateria

APIs

Supondo que a configuração tenha sido bem-sucedida até agora, o app OEM especificado na configuração deve ser capaz de chamar o método associado no PowerManager para acionar o modo de economia de bateria:

public boolean setDynamicPowerSaveHint(boolean powerSaveHint, int disableThreshold)

Se a opção de programação de economia de bateria com base na rotina estiver ativada e o app chamar esse método com um valor true para powerSaveHint, a economia de bateria será ativada. Especifique disableThreshold para que, se o app não conseguir se comunicar com o sistema, ele ainda saiba em qual porcentagem da bateria é seguro desativar o modo de economia de bateria.

Essa API está sujeita a substituições do usuário e adiamentos da economia de bateria da mesma forma que a economia de bateria automática baseada em porcentagem. Consulte a documentação da API para mais informações.

Para verificar se as APIs foram chamadas, consulte as configurações globais para verificar se a configuração de suporte mudou o valor de acordo com as chamadas de API.

Por exemplo, se o usuário selecionou o modo Economia de bateria de rotina e o app está chamando setDynamicPowerSaveHint(true, 10), as configurações globais terão estes valores:

automatic_power_save_mode: 1
dynamic_power_savings_disable_threshold: 10
dynamic_power_savings_enabled: 1

Se você chamar setDynamicPowerSaveHint(false, 25), os valores serão:

automatic_power_save_mode: 1
dynamic_power_savings_disable_threshold: 25
dynamic_power_savings_enabled: 0

É possível verificar esses valores usando o comando adb:

adb shell settings get global <setting-name>

Verificação

Não há uma maneira automatizada de verificar esse recurso, porque não há como saber qual comportamento um OEM vai usar para decidir quando acionar o modo de economia de bateria de rotina. Os OEMs são responsáveis por testar a integração para garantir que o comportamento atenda às expectativas. Em particular, verifique se o dispositivo pode realizar as seguintes tarefas:

  • O usuário seleciona com base na porcentagem na interface da programação do modo de economia de bateria e seleciona 15%. A economia de bateria só precisa ser ativada automaticamente quando a bateria estiver em 15%.
  • O usuário seleciona com base na rotina na interface da programação de economia de bateria. Quando o app chama a API com true, a economia de bateria é ativada. Além disso, a Economia de bateria é desativada automaticamente se o dispositivo for carregado até o limite indicado e desconectado.
  • O usuário seleciona nenhum na interface da programação do modo de economia de bateria. A Economia de bateria NUNCA deve ser ativada automaticamente.
  • Se o app ativar o modo de economia de bateria e o usuário substituir manualmente o modo de economia de bateria para que ele seja desativado novamente (usando as Configurações rápidas, Configurações etc.), ele vai permanecer DESATIVADO até que o usuário o reative manualmente ou conecte o dispositivo.