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
idleBạ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
Enum
"đang hoạt động"
"idle"
"đã khoá"
Phương thức
getAutoLockDelay()
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ố
callbacksẽ 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ênLờ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()
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ố
callbacksẽ có dạng như sau:(newState: IdleState) => void
-
newState
-
Giá trị trả về
-
Promise<IdleState>
Chrome 116 trở lênLờ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.