chrome.idle

Mô tả

Sử dụng API chrome.idle để phát hiện thời điểm trạng thái không hoạt động 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 không hoạt động. Ví dụ:

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

Loại

IdleState

Chrome 44 trở lên

Enum

"active"

"không hoạt động"

"locked"

Phương thức

getAutoLockDelay()

Chrome 73 trở lên Chỉ dành cho ChromeOS 
chrome.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 ở 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á. Hiện chỉ được hỗ trợ trên ChromeOS.

Giá trị trả về

  • Promise<number>

    Chrome 116 trở lên

queryState()

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

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

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 phát hiện thao tác nhập gần đây nhất của người dùng.

Giá trị trả về

setDetectionInterval()

chrome.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

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

Kích hoạt khi hệ thống chuyển sang trạng thái đang hoạt động, rảnh hoặc bị khoá. Sự kiện này sẽ kích hoạt với 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 kích hoạt, "idle" (không hoạt động) nếu hệ thống không bị khoá và người dùng không tạo bất kỳ dữ liệu đầu vào nào trong một số giây nhất định, và "active" (đang hoạt động) khi người dùng tạo dữ liệu đầ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