chrome.power

refresh date: 2026-09-25 robots: noindex

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 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 API nguồn, một ứng dụng hoặc tiện ích có thể giữ cho hệ thống ở trạng thái 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 mờ 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ụ: ứng dụng sách điện tử và ứng dụng 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 sử dụng điện có mức độ ưu tiên cao nhất sẽ có hiệu lực; "display" luôn có mức độ ưu tiên cao hơn "system". Ví dụ: nếu ứng dụng A yêu cầu quản lý nguồn "system" 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ỡ tải 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

Giải phóng một yêu cầu đã được thực hiện trước đó thông qua requestKeepAwake().

reportActivity()

Promise Chrome 113 trở lên Chỉ ChromeOS 
chrome.power.reportActivity(
  callback?: function,
): 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 làm tối hoặc tắt hoặc từ trình bảo vệ màn hình. Thoát 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.

Thông số

  • callback

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

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

    () => void

Giá trị trả về

  • Promise<void>

    Chỉ Manifest V3 trở lên mới hỗ trợ Promise, 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,
): void

Yêu cầu tạm thời tắt 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ị tắt. 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ố