browser.idle

Mô tả

Sử dụng API chrome.idle để phát hiện thời điểm trạng thái rảnh của máy thay đổi.

Quyền

idle

Bạn phải khai báo quyền "idle" trong tệp kê khai của tiện ích để sử dụng API rảnh. Ví dụ:

{
  "name": "My extension",
  ...
  "permissions": [
    "idle"
  ],
  ...
}

Loại

IdleState

Trình duyệt Chrome 44 trở lên .* kể từ Chrome 148

Enum

"đang hoạt động"

"idle"

"locked"

Phương thức

getAutoLockDelay()

Trình duyệt Chrome 73 trở lên. * kể từ Chrome 148 Chỉ dành cho ChromeOS

browser.idle.getAutoLockDelay(): Promise<number>

Lấy thời gian (tính bằng giây) cho đến khi màn hình tự động khoá khi không hoạt động. Trả về thời lượng bằng 0 nếu màn hình không bao giờ tự động khoá. Hiện chỉ được hỗ trợ trên ChromeOS.

Giá trị trả về

• Promise<number>

  Chrome 116 trở lên browser.* kể từ Chrome 148

queryState()

browser.idle.queryState(
  detectionIntervalInSeconds: number,
): Promise<IdleState>

Trả về "locked" (đã khoá) nếu hệ thống bị khoá, "idle" (không hoạt động) nếu người dùng không tạo bất kỳ hoạt động đầu vào nào trong một số giây nhất định hoặc "active" (đang hoạt động) nếu không.

Thông số

• detectionIntervalInSeconds

  số

  Hệ thống được coi là ở trạng thái rảnh nếu đã trôi qua detectionIntervalInSeconds giây kể từ lần gần nhất phát hiện hoạt động đầu vào của người dùng.

Giá trị trả về

• Promise<IdleState>

  Chrome 116 trở lên browser.* kể từ Chrome 148

setDetectionInterval()

browser.idle.setDetectionInterval(
  intervalInSeconds: number,
): void

Đặt khoảng thời gian (tính bằng giây) dùng để xác định thời điểm hệ thống ở trạng thái rảnh cho các sự kiện onStateChanged. Khoảng thời gian mặc định là 60 giây.

Thông số

• intervalInSeconds

  số

  Ngưỡng (tính bằng giây) dùng để xác định thời điểm hệ thống ở trạng thái rảnh.

Sự kiện

onStateChanged

browser.idle.onStateChanged.addListener(
  callback: function,
)

Được kích hoạt khi hệ thống chuyển sang trạng thái hoạt động, rảnh hoặc bị khoá. Sự kiện này kích hoạt trạng thái "locked" (đã khoá) nếu màn hình bị khoá hoặc trình bảo vệ màn hình được kích hoạt, trạng thái "idle" (không hoạt động) nếu hệ thống được mở khoá và người dùng không tạo bất kỳ hoạt động đầu vào nào trong một số giây nhất định, và trạng thái "active" (đang hoạt động) khi người dùng tạo hoạt động đầu vào trên một hệ thống không hoạt động.

Thông số

• callback

  hàm

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

  (newState: IdleState) => void

  • newState

    IdleState