chrome.power

Mô tả

Sử dụng API chrome.power để ghi đè các tính năng quản lý nguồn của hệ thống.

Quyền

power

Cách sử dụng

Theo mặc định, hệ điều hành làm mờ màn hình khi người dùng không hoạt động và cuối cùng tạm ngưng hệ thống. Với API nguồn, ứng dụng hoặc tiện ích có thể giúp hệ thống luôn bật.

Bằng cách sử dụng API này, bạn có thể chỉ định Cấp để tắt tính năng quản lý nguồn. "system" giúp giữ cho hệ thống luôn hoạt động nhưng cho phép làm mờ hoặc tắt màn hình. Ví dụ: một ứng dụng liên lạc có thể tiếp tục nhận tin nhắn khi màn hình đang tắt. Cấp độ "display" giúp màn hình và hệ thống luôn hoạt động. Ví dụ: ứng dụng sách điện tử và bản trình bày có thể giữ lại màn hình và hệ thống hoạt động trong khi người dùng đọc.

Khi người dùng có nhiều ứng dụng hoặc tiện ích đang hoạt động, mỗi ứng dụng hoặc tiện ích có mức năng lượng riêng, mức ưu tiên cao nhất sẽ có hiệu lực; "display" luôn được ưu tiên hơn "system". Cho ví dụ: nếu ứng dụng A yêu cầu "system" quản lý nguồn pin nhưng ứng dụng B yêu cầu "display", "display" được dùng cho đến khi ứng dụng B bị huỷ tải hoặc giải phóng yêu cầu của nó. Nếu ứng dụng A vẫn đang hoạt động, "system" sẽ sau đó được sử dụng.

Loại

Level

Enum

"system"
Ngăn hệ thống chuyển sang chế độ ngủ để phản hồi không hoạt động của người dùng.

"display"
Ngăn không cho tắt hoặc làm mờ màn hình, hoặc ngăn hệ thống chuyển sang chế độ ngủ do người dùng không hoạt động.

Phương thức

releaseKeepAwake()

chrome.power.releaseKeepAwake()

Huỷ bỏ một yêu cầu đã thực hiện trước đó thông qua requestKeepAwake().

reportActivity()

Lời hứa Chrome 113 trở lên Chỉ ChromeOS 
chrome.power.reportActivity(
  callback?: function,
)

Báo cáo một hoạt động của người dùng để đánh thức màn hình ở trạng thái giảm độ sáng hoặc tắt, hoặc từ trình bảo vệ màn hình. Thoát khỏi trình bảo vệ màn hình nếu trình bảo vệ màn hình hiện đang hoạt động.

Tham số

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau: 

    () => void

Giá trị trả về

  • Lời hứa<vô hiệu>

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

requestKeepAwake()

chrome.power.requestKeepAwake(
  level: Level,
)

Yêu cầu tắt tính năng quản lý nguồn tạm thời. level mô tả mức độ cần tắt tính năng quản lý nguồn. Nếu một yêu cầu trước đây do ứng dụng đó đưa ra vẫn còn hiệu lực, thì yêu cầu đó sẽ được thay thế bằng yêu cầu mới.

Tham số