日常安排省電模式

Android 10 推出了名為「根據日常安排」的省電排程選項。這個選項可讓原始設備製造商 (OEM) 選擇的應用程式向系統提供信號，以便更智慧地安排省電模式。這個選項需要設定，但實作方式並非強制規定。

裝置設定

供應商規格

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

舉例來說，如果您希望應用程式套件 com.google.android.apps.turbo 控制「根據例行動作」設定，請設定以下設定值：

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

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

預設關閉閾值

新的 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，請進行全域查詢設定，驗證根據 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」。省電模式應該會自動開啟。
  • 如果應用程式開啟省電模式，且使用者手動覆寫省電模式以再次關閉 (例如透過「快速設定」、「設定」等)，則應「保持關閉」，直到使用者手動重新開啟或接上裝置為止。