Chế độ chờ TV

Trên Android 11, giấc ngủ không tập trung là một tính năng tiết kiệm pin, cho phép đặt thời gian chờ không hoạt động của người dùng. Sau đó, màn hình sẽ tắt, ngay cả khi các cửa sổ có FLAG_KEEP_SCREEN_ON đang 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ữ. 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 hoạt động 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ể thiết lập 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 thị một mục lựa chọn ư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 về 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

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

Triển khai

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

  1. Ghi đè giá trị mặc định config_attentiveTimeout.
  2. Nếu sử dụng AOSP TvSettings:
    • 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ả

Bạn có thể kiểm thử CTS cho tính năng này tại 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.