Rutynowe oszczędzanie baterii

W Androidzie 10 wprowadzamy opcję harmonogramu oszczędzania baterii o nazwie na podstawie rutyny. Dzięki tej opcji aplikacja wybrana przez producenta OEM dostarcza sygnały do systemu, co pozwala na bardziej inteligentne planowanie oszczędzania baterii. Ta opcja wymaga skonfigurowania i jest opcjonalna.

Konfiguracja urządzenia

Specyfikacja dostawcy

Aby powiadomić interfejs ustawień, że urządzenie jest skonfigurowane prawidłowo, użyj config w celu zastąpienia wartości config_batterySaverScheduleProvider na nazwa pakietu Twojej aplikacji.

Jeśli na przykład chcesz, aby pakiet aplikacji com.google.android.apps.turbo użyj ustawienia na podstawie rutyny, ustaw tę wartość konfiguracji:

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

Telefon powinien teraz wyświetlić opcję na podstawie rutyny. Aby to sprawdzić, utwórz obraz, Flash go w telefonie i wybierz kolejno Ustawienia > Bateria > Akumulatorowe Oszczędzanie > Harmonogram oszczędzania baterii. Powinna się wyświetlić opcja na podstawie procedury.

Domyślny próg wyłączenia

Nowe pole config_dynamicPowerSavingsDefaultDisableThreshold określa parametr poziom naładowania baterii, przy którym system wyłącza oszczędzanie baterii (jeśli było włączone) przez algorytm szeregowania na podstawie rutyny. Domyślne ustawienie systemu to 80%, ale możesz i ją zmienić.

Konfiguracja aplikacji

Uprawnienia

Interfejsy API potrzebne aplikacji do włączania oszczędzania baterii są chronione dzięki uprawnieniom android.permission.POWER_SAVER. To jest uprawnienia do podpisu/uprawnień, przyznaj więc aplikację, którą chcesz aktywować oszczędzanie baterii w aplikacji privapp-whitelist.

Przykład przyznania aplikacji uprawnienia privapp:

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

Jeśli nie przyznasz wstępnie tych uprawnień wersji aplikacji w systemie aplikacja nie może uzyskać tych uprawnień ani prawidłowo wywoływać interfejsów API. System nie przekazuje żadnych informacji o błędach poza zwykłymi błędami dotyczącymi uprawnień, więc sprawdź, czy możesz wywoływać interfejsy API i obserwować ich działanie.

Instalacja

Aby funkcja Na podstawie rutyny działała prawidłowo, musisz wstępnie zainstalować aplikację i obraz systemu z wymaganymi uprawnieniami. Daj POWER_SAVER tylko jednej aplikacji i zezwolić mu na kontrolowanie interfejsów API opartych na rutynie. Zachowanie tej funkcji, gdy więcej niż 1 aplikacja próbuje użyć uprawnienia i interfejsów API, nie jest obsługiwane ani określone.

Włączanie oszczędzania baterii

Interfejsy API

Zakładając, że konfiguracja się udała, aplikacja OEM określona w konfiguracji powinna możliwość wywołania powiązanej metody w usłudze PowerManager w celu aktywowania oszczędzanie baterii:

public boolean setDynamicPowerSaveHint(boolean powerSaveHint, int disableThreshold)

Jeśli włączona jest opcja harmonogramu oszczędzania baterii na podstawie rutyny, a aplikacja wywołuje tę metodę z wartością true dla parametru powerSaveHint, oszczędzanie baterii włącza się. Określ disableThreshold, tak aby aplikacja nie mogła się komunikować z: system nadal będzie znał poziom naładowania baterii, który można bezpiecznie włączyć wyłączyć oszczędzanie baterii.

Ten interfejs API może w taki sam sposób stosować ustawienia oszczędzania baterii przez użytkowników jako automatycznego oszczędzania baterii procentowo. Zobacz Dokumentacja interfejsu API .

Aby sprawdzić, czy interfejsy API są wywoływane, wykonaj globalne zapytanie, aby sprawdzić, czy wartość ustawienia bazowego zmienia się według wywołań interfejsu API.

Na przykład: jeśli użytkownik wybrał rutynowy tryb oszczędzania baterii, a aplikacja jest wywołującego setDynamicPowerSaveHint(true, 10), ustawienia globalne powinny mieć te wartości:

automatic_power_save_mode: 1
dynamic_power_savings_disable_threshold: 10
dynamic_power_savings_enabled: 1

Jeśli następnie wywołasz funkcję setDynamicPowerSaveHint(false, 25), powinny one wyglądać tak:

automatic_power_save_mode: 1
dynamic_power_savings_disable_threshold: 25
dynamic_power_savings_enabled: 0

Możesz sprawdzić te wartości za pomocą tego polecenia adb:

adb shell settings get global <setting-name>

Weryfikacja

Nie można zweryfikować tej funkcji automatycznie, ponieważ nie można się o tym dowiedzieć Jakiego zachowania zastosuje producent OEM, aby zdecydować, kiedy włączyć rutynowe oszczędzanie baterii? i trybu uzyskiwania zgody. OEM jest więc odpowiedzialny za testowanie integracji, aby mieć pewność, sposób działania jest zgodny z oczekiwaniami. W szczególności sprawdź, czy urządzenie może wykonaj następujące zadania:

  • Użytkownik wybiera na podstawie procentu w interfejsie harmonogramu oszczędzania baterii i wybiera 15%. Oszczędzanie baterii powinno włączyć się automatycznie TYLKO wtedy, gdy jak bateria jest naładowana do 15%.
  • Użytkownik wybiera opcję na podstawie rutyny w interfejsie harmonogramu oszczędzania baterii. Kiedy aplikacja wywołuje interfejs API, używając funkcji true, włącza się oszczędzanie baterii. Dodatkowo oszczędzanie baterii wyłącza się automatycznie, jeśli urządzenie jest naładowane do wskazanego progu i jest odłączone od zasilania.
  • Użytkownik wybiera brak w interfejsie harmonogramu oszczędzania baterii. Oszczędzanie baterii NIGDY nie powinno włączać się automatycznie.
  • Jeśli aplikacja włączy oszczędzanie baterii, a użytkownik ręcznie zastąpi ją innymi wygaszacza, aby wyłączyć go ponownie (za pomocą Szybkich ustawień, Ustawień itp.), powinien NASTĘPNIE WYŁĄCZONE, dopóki użytkownik nie włączy go ponownie ręcznie albo nie podłączy urządzenia.