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 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 được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp cho khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Chiến lược phát hành đĩa đơn Promise phân giải cùng loại được truyền đến 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ố