電視待機

在 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. 使用 Android 開放原始碼計畫 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. 開始播放影片 (以取得螢幕喚醒鎖定)。
  4. 確認睡眠警告對話方塊在幾秒後顯示。
  5. 確認設定的逾時期限到期後，螢幕會關閉。