Chế độ chờ của TV

Trong Android 11, chế độ ngủ không chú ý là một tính năng tiết kiệm pin cho phép đặt thời gian chờ khi người dùng không hoạt động, sau đó màn hình sẽ tắt, ngay cả khi các cửa sổ có FLAG_KEEP_SCREEN_ON hiển thị hoặc khoá chế độ thức ở cấp FULL_WAKE_LOCK, SCREEN_BRIGHT_WAKE_LOCK hoặc SCREEN_DIM_WAKE_LOCK được giữ lại. Tính năng này không ảnh hưởng đến các khoá chế độ thức ở cấp PARTIAL_WAKE_LOCK. Ngay trước khi hết thời gian chờ, một thông báo có thể xuất hiện để cảnh báo người dùng rằng thiết bị sẽ chuyển sang trạng thái ngủ nếu họ không tương tác với thiết bị.

Trong ngữ cảnh này, hoạt động của người dùng đề cập đến mọi thứ kích hoạt lệnh gọi đến PowerManager#userActivity (không có cờ USER_ACTIVITY_FLAG_NO_CHANGE_LIGHTS), bao gồm nhưng không giới hạn ở:

  • Tương tác với màn hình cảm ứng
  • Nhấn nút vật lý
  • Sự kiện đầu vào từ một phụ kiện bên ngoài (ví dụ: bàn phím đã kết nối, điều khiển từ xa qua Bluetooth, điều khiển từ xa qua hồng ngoại)
  • Tương tác bằng giọng nói
  • Nhận một số thông báo HDMI CEC nhất định, chẳng hạn như One Touch Play
  • Bắt đầu một phiên truyền mới

Tuỳ chỉnh

Nếu tính năng này được bật, thiết bị sẽ hiển thị cảnh báo trên màn hình sau một khoảng thời gian không hoạt động nhất định của người dùng. Nếu không có hành động nào được thực hiện, màn hình sẽ tắt. Bạn có thể tuỳ chỉnh tính năng này bằng các tuỳ chọn cấu hình sau.

Định cấu hình thời gian chờ

Để định cấu hình thời gian chờ, hãy cập nhật phần tử sau trong frameworks/base/core/res/res/values/config.xml:

  • config_attentiveTimeout
    • Chỉ định thời gian mặc định (tính bằng mili giây) mà người dùng không hoạt động sau đó màn hình sẽ tắt (ngay cả khi có chế độ khoá chế độ thức màn hình).
    • Đặt tại thời điểm tạo bản dựng.
    • Nếu giá trị nằm trong khoảng từ 0 đến config_minimumScreenOffTimeout, thì thời gian chờ sẽ được đặt thành config_minimumScreenOffTimeout để ngăn thiết bị tắt màn hình ngay sau khi thức dậy.
    • Mặc định: -1, tắt tính năng này.

Ghi đè thời gian chờ mặc định

Để ghi đè chế độ cài đặt thời gian chờ mặc định, hãy cập nhật phần tử sau.

  • Settings.Secure.ATTENTIVE_TIMEOUT
    • Nếu được đặt, sẽ ghi đè thời gian chờ ngủ khi không chú ý mặc định do config_attentiveTimeout đặt.
    • Có thể được đặt trong thời gian chạy.

Định cấu hình thời lượng trước khi cảnh báo xuất hiện

Để định cấu hình thời lượng, hãy cập nhật phần tử sau trong frameworks/base/core/res/res/values/config.xml:

  • config_attentiveWarningDuration
    • Khoảng thời gian hiển thị thông báo cảnh báo cho người dùng trước khi màn hình tắt sau khi người dùng không hoạt động trong thời gian dài.
    • Giá trị này phải thấp hơn nhiều so với thời gian chờ khi không chú ý đã đặt, nếu không, hộp thoại cảnh báo sẽ liên tục hiển thị và không thể đóng được.
    • Mặc định: 30000 (30 giây).

Hiển thị các tuỳ chọn thời gian chờ trong TvSettings

Để hiển thị các lựa chọn ưu tiên về thời gian chờ, hãy cập nhật phần tử sau trong packages/apps/TvSettings/Settings/res/values/config.xml:

  • config_show_standby_timeout
    • Liệu có hiện một mục ưu tiên để cho phép tắt màn hình trong khi phát nội dung nghe nhìn hay không.
    • Mặc định: false.

Tài nguyên cho giao diện người dùng cảnh báo

  • Bố cục của hộp thoại cảnh báo được xác định trong frameworks/base/packages/SystemUI/res/layout/inattentive_sleep_warning.xml.
  • Các chuỗi sau đây cho hộp thoại được xác định trong frameworks/base/packages/SystemUI/res/values/strings.xml và frameworks/base/packages/SystemUI/res-product/values/strings.xml.
    • inattentive_sleep_warning_title
    • inattentive_sleep_warning_message

Bạn có thể thay đổi cấu hình và tài nguyên thời gian xây dựng bằng lớp phủ tài nguyên.

Triển khai

Bật tính năng này bằng cách sau.

  1. Ghi đè config_attentiveTimeout mặc định.
  2. Nếu sử dụng TvSettings AOSP:
    • Tắt tính năng này trong phần cài đặt bằng cách ghi đè config_show_standby_timeout.
    • Triển khai chế độ cài đặt của riêng bạn để đặt Settings.Secure.ATTENTIVE_TIMEOUT.

Xác nhận kết quả

Các chương trình kiểm thử CTS cho tính năng này nằm ở cts/hostsidetests/os/src/android/os/cts/InattentiveSleepTests.java.

Ví dụ và nguồn

  • frameworks/base/packages/SystemUI/src/com/android/systemui/power/InattentiveSleepWarningView.java chứa cách triển khai giao diện người dùng cảnh báo mặc định.
  • packages/apps/TvSettings cung cấp ví dụ về cách hiển thị tính năng này trong phần cài đặt.

Ví dụ về trường hợp kiểm thử thủ công

  1. Đảm bảo chế độ cài đặt cho nhà phát triển stay_on_while_plugged_in đang tắt nếu HAL trạng thái của thiết bị báo cáo rằng thiết bị có pin (battery_present là true) vì điều này có thể ngăn tính năng tắt màn hình.
    adb shell settings put global stay_on_while_plugged_in 0

  2. Đặt thời gian chờ khi người dùng không chú ý nhiều hơn vài giây so với thời lượng của hộp thoại cảnh báo.
    adb shell settings put secure attentive_timeout 32000
  3. Bắt đầu phát video (để có được khoá chế độ thức màn hình).
  4. Xác minh rằng hộp thoại cảnh báo về giấc ngủ xuất hiện sau vài giây.
  5. Xác minh rằng màn hình tắt sau khi hết thời gian chờ đã đặt.