日常安排省電模式

Android 10 推出了省電時間表選項 依日常安排這個選項可讓原始設備製造商 (OEM) 選擇的應用程式向系統提供信號，以便更智慧地安排省電模式。這個選項需要設定，且您可以選擇是否實作。

裝置設定

供應商規格

如要通知「設定」 UI 裝置設定正確無誤，請使用 設定疊加層，將 config_batterySaverScheduleProvider 值覆寫為 應用程式的套件名稱

舉例來說，如果要將 com.google.android.apps.turbo 應用程式套件 定義根據處理常式設定，接著應設定此設定值：

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

現在手機應會顯示「根據日常安排」選項。如要驗證，請建構映像檔、將其閃燈至手機，然後依序前往「設定」>「電池」>「省電模式」>「省電模式時間表」。畫面上應該會顯示「 based on routine」選項。

預設關閉閾值

新的 config_dynamicPowerSavingsDefaultDisableThreshold 欄位會指定 系統關閉省電模式時關閉的電池電量 (如果開啟的話) 依據以處理常式排程器為準。系統預設值為 80%，但您也可以 變更內容。

應用程式設定

權限

從應用程式開啟省電模式時，應用程式所需的 API 會受到保護 具備 android.permission.POWER_SAVER 權限。這是 請授予簽章/特殊權限，因此請授予您要觸發的應用程式 省電模式 (適用於privapp-whitelist)。

將 privapp 權限授予應用程式的範例：

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

如未將這項權限預先授予系統上的應用程式版本 映像檔，應用程式就無法取得權限，也無法正確呼叫 API。 除了一般權限錯誤以外，系統不會提供任何意見回饋，因此 確認是否可以呼叫 API 並觀察其影響。

安裝

為了讓根據日常安排正常運作，您必須在 具備必要權限的系統映像檔只給一個應用程式 POWER_SAVER 並允許其控制根據處理常式 API。行為 如果有多個應用程式嘗試使用權限，且 API 並未顯示 不支援及未指定

觸發省電模式

API

假設設定已順利完成，則設定中所指定的原始設備製造商 (OEM) 應用程式應該設定成功 才能順利在 PowerManager 中呼叫相關聯的方法以觸發 省電模式：

public boolean setDynamicPowerSaveHint(boolean powerSaveHint, int disableThreshold)

如果啟用「依據日常安排」省電模式時間表選項，且應用程式以 powerSaveHint 的 true 值呼叫此方法，則省電模式會開啟。指定 disableThreshold，以便在應用程式無法通訊時 但系統仍可知道在電量剩多少百分比時 已關閉省電模式。

這個 API 會根據百分比自動省電模式，接受使用者覆寫和省電模式暫停的設定。詳情請參閱 API 說明文件 瞭解詳情

如要確認 API 是否成功呼叫，請全域查詢設定以驗證 備份設定已變更值

舉例來說，如果使用者選取日常安排省電模式模式，且應用程式 呼叫 setDynamicPowerSaveHint(true, 10) 時，全域設定應具有 這些值：

automatic_power_save_mode: 1
dynamic_power_savings_disable_threshold: 10
dynamic_power_savings_enabled: 1

如果接著呼叫 setDynamicPowerSaveHint(false, 25)，值應為：

automatic_power_save_mode: 1
dynamic_power_savings_disable_threshold: 25
dynamic_power_savings_enabled: 0

您可以使用以下 adb 指令檢查這些值：

adb shell settings get global <setting-name>

驗證

由於無法判斷，系統無法自動驗證此功能 原始設備製造商 (OEM) 決定觸發日常安排省電模式的時機 模式。因此，原始設備製造商 (OEM) 必須負責測試整合情形， 行為符合預期具體來說，請確認裝置 完成下列工作：

  • 使用者在省電模式時間表 UI 中，選取「根據百分比」 然後選取 15%省電模式應只在電量剩下 15% 時自動開啟。
  • 使用者在省電模式時間表 UI 中選取「根據日常安排」。當應用程式使用 true 呼叫 API 時，省電模式就會開啟。此外， 如果裝置充電至 並且未接上電源
  • 使用者在省電模式排程 UI 中選取「none」。省電模式絕不應自動開啟。
  • 如果應用程式開啟省電模式，但使用者手動覆寫電池電力 即可再次關閉 (使用快速設定、設定等) 時，應保持關閉狀態 關閉，直到使用者手動重新開啟，或將 同時監控每部裝置的位置