chrome.idle

Mô tả

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 ở trạng thái rảnh. Ví dụ:

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

Loại

IdleState

Chrome 44 trở lên

Enum

"đang hoạt động"

"idle"

"đã khoá"

Phương thức

getAutoLockDelay()

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

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

Tham số

  • số gọi lại

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

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

    (delay: number) => void

    • trì hoãn

      số

      Thời gian tính bằng giây cho đến khi màn hình tự động khoá khi ở trạng thái rảnh. Giá trị này là 0 nếu màn hình không bao giờ tự động khoá.

Giá trị trả về

  • Promise<number>

    Chrome 116 trở lên

    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.

queryState()

Lời hứa
chrome.idle.queryState(
  detectionIntervalInSeconds: number,
  callback?: function,
)

Trả về trạng thái "đã khoá" nếu hệ thống bị khoá, thì "không hoạt động" nếu người dùng không tạo bất kỳ dữ liệu đầu vào nào trong số giây được chỉ định hoặc "đang hoạt động" nếu không.

Tham số

  • detectionIntervalInSeconds

    số

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

  • số gọi lại

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

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

    (newState: IdleState) => void

Giá trị trả về

  • Promise<IdleState>

    Chrome 116 trở lên

    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.

setDetectionInterval()

chrome.idle.setDetectionInterval(
  intervalInSeconds: number,
)

Đặ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.

Tham 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

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

Được kích hoạt khi hệ thống chuyển sang trạng thái đang hoạt động, ở trạng thái rảnh hoặc bị khoá. Sự kiện kích hoạt kèm theo nhãn "đã khoá" nếu màn hình bị khoá hoặc trình bảo vệ màn hình kích hoạt, thì trạng thái "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ỳ dữ liệu đầu vào nào trong số giây được chỉ định, và trạng thái "đang hoạt động" khi người dùng tạo dữ liệu đầu vào trên một hệ thống ở trạng thái rảnh.

Tham số

  • số gọi lại

    hàm

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

    (newState: IdleState) => void