電視待機

在 Android 11 中，無意識休眠是一種省電功能，可讓系統設定使用者閒置逾時時間，並在逾時後關閉螢幕，即使顯示含有 FLAG_KEEP_SCREEN_ON 的視窗，或持有 FULL_WAKE_LOCK、SCREEN_BRIGHT_WAKE_LOCK 或 SCREEN_DIM_WAKE_LOCK 等級的 Wake Lock 也一樣。這項功能不會影響等級 PARTIAL_WAKE_LOCK 的 Wake Lock。 在逾時期限到期前不久，系統可以顯示訊息，警告使用者如果未與裝置互動，裝置將進入休眠狀態。

在此情況下，使用者活動是指任何會觸發呼叫 PowerManager#userActivity (沒有USER_ACTIVITY_FLAG_NO_CHANGE_LIGHTS 標記)，包括但不限於：

  • 與觸控螢幕互動
  • 按下實體按鈕
  • 外部配件的輸入事件 (例如已連線的鍵盤、藍牙遙控器、紅外線遙控器)
  • 語音互動
  • 接收特定 HDMI CEC 訊息，例如 One Touch Play
  • 開始新的投放工作階段

自訂

如果啟用這項功能，裝置會在使用者閒置一段指定時間後，在畫面上顯示警告。如未執行任何動作，螢幕將會關閉。可以自訂這項功能 就會使用這些設定選項

設定逾時

如要設定逾時值，請在 frameworks/base/core/res/res/values/config.xml 中更新下列元素：

  • config_attentiveTimeout
    • 指定使用者閒置的預設時間 (以毫秒為單位)，超過這個時間後，螢幕就會關閉 (即使已設定螢幕喚醒鎖定)。
    • 在建構期間設定。
    • 如果值介於 0 和 config_minimumScreenOffTimeout 之間，逾時時間就會設為 config_minimumScreenOffTimeout，以免裝置在喚醒後不久就關閉螢幕。
    • 預設值：-1，會停用這項功能。

覆寫預設逾時設定

如要覆寫預設的逾時設定，請更新下列元素。

  • Settings.Secure.ATTENTIVE_TIMEOUT
    • 如果設定，會覆寫 config_attentiveTimeout。
    • 可在執行階段設定。

設定顯示警告前的時間長度

如要設定時間長度，請在 frameworks/base/core/res/res/values/config.xml 中更新下列元素：

  • config_attentiveWarningDuration
    • 在使用者長時間未操作後，系統顯示警告訊息的時間長度，之後螢幕就會關閉。
    • 這個值應該遠低於設定的侵略性睡眠逾時，否則 「警告對話方塊」 會持續顯示，且無法關閉
    • 預設值：30000 (30 秒)。

在 TvSettings 中顯示逾時偏好設定

如要顯示逾時偏好設定，請在 packages/apps/TvSettings/Settings/res/values/config.xml 中更新下列元素：

  • config_show_standby_timeout
    • 是否顯示允許在播放媒體時關閉螢幕的偏好設定項目。
    • 預設值：false。

警告 UI 的資源

  • 警告對話方塊的版面配置是在 frameworks/base/packages/SystemUI/res/layout/inattentive_sleep_warning.xml 中定義。
  • 對話方塊的下列字串已在 frameworks/base/packages/SystemUI/res/values/strings.xml 和 frameworks/base/packages/SystemUI/res-product/values/strings.xml 中定義。
    • inattentive_sleep_warning_title
    • inattentive_sleep_warning_message

資源重疊可以變更建構時間設定和資源。

實作

請使用下列指令啟用這項功能。

  1. 覆寫預設的 config_attentiveTimeout。
  2. 如果使用 AOSP TvSettings：
    • 覆寫 config_show_standby_timeout，在設定中停用這項功能。
    • 實作自己的設定 設定 Settings.Secure.ATTENTIVE_TIMEOUT。

驗證

相關功能的 CTS 測試如下 cts/hostsidetests/os/src/android/os/cts/InattentiveSleepTests.java。

範例和來源

  • frameworks/base/packages/SystemUI/src/com/android/systemui/power/InattentiveSleepWarningView.java 包含預設的警告 UI 實作。
  • packages/apps/TvSettings 提供範例，說明如何在 可以管理叢集設定，像是節點 資源調度、安全性和其他預先設定項目

手動測試案例

  1. 如果裝置的健康 HAL 回報裝置有電池 (battery_present 為 true)，請務必關閉 stay_on_while_plugged_in 開發人員設定，因為這可能會導致裝置無法關閉螢幕。
    adb shell settings put global stay_on_while_plugged_in 0

  2. 將未注意睡眠逾時時間設為比警告對話方塊時間長幾秒。
    adb shell settings put secure attentive_timeout 32000
  3. 開始播放影片 (開啟螢幕 Wake Lock)。
  4. 確認睡眠警告對話方塊在幾秒後顯示。
  5. 確認螢幕在設定逾時期限過後關閉。