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

Khái niệm và cách sử dụng

Theo mặc định, hệ điều hành sẽ làm tối màn hình khi người dùng không hoạt động và cuối cùng sẽ tạm ngưng hệ thống. Với Power API, một ứng dụng hoặc tiện ích có thể giữ cho hệ thống hoạt động.

Khi sử dụng API này, bạn có thể chỉ định Cấp độ mà tính năng quản lý nguồn bị tắt. Cấp độ "system" duy trì trạng thái hoạt động của hệ thống, nhưng cho phép màn hình ở chế độ làm tối hoặc tắt. Ví dụ: một ứng dụng giao tiếp có thể tiếp tục nhận tin nhắn trong khi màn hình tắt. Cấp độ "display" duy trì trạng thái hoạt động của màn hình và hệ thống. Ví dụ: các ứng dụng sách điện tử và trình bày có thể giữ cho 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/tiện ích có một mức sử dụng điện 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". Ví dụ: nếu ứng dụng A yêu cầu "system" quản lý nguồn và ứng dụng B yêu cầu "display", thì "display" sẽ được dùng cho đến khi ứng dụng B được gỡ hoặc giải phóng yêu cầu. Nếu ứng dụng A vẫn đang hoạt động, thì "system" sẽ được dùng.

Loại

Level

Enum

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

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

Phương thức

releaseKeepAwake()

chrome.power.releaseKeepAwake(): void

Phát hành một yêu cầu đã được thực hiện trước đó thông qua requestKeepAwake().

reportActivity()

Chrome 113 trở lên Chỉ dành cho ChromeOS
chrome.power.reportActivity(): Promise<void>

Báo cáo hoạt động của người dùng để đánh thức màn hình từ trạng thái mờ 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 này đang hoạt động.

Giá trị trả về

  • Promise<void>

requestKeepAwake()

chrome.power.requestKeepAwake(
  level: Level,
)
: void

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

Thông số