Nội dung 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
Tệp kê khai
Bạn phải khai báo quyền "không hoạt động" 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
Liệt kê
Phương thức
getAutoLockDelay()
chrome.idle.getAutoLockDelay(
callback?: function,
)
Xem thời gian (tính bằng giây) cho đến khi màn hình tự động bị 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
number
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 bằng 0 nếu màn hình không bao giờ tự động khoá.
-
Giá trị trả về
-
Hứa hẹn<number>
Chrome 116 trở lênLời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.
queryState()
chrome.idle.queryState(
detectionIntervalInSeconds: number,
callback?: function,
)
Trả về "khoá" nếu hệ thống bị khoá, "không hoạt động" nếu người dùng chưa 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 có vấn đề.
Tham số
-
detectionIntervalInSeconds
number
Hệ thống được coi là ở trạng thái không hoạt động nếu các giây releaseIntervalInSeconds đã 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
-
newState
-
Giá trị trả về
-
Promise<IdleState>
Chrome 116 trở lênLời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng 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
number
Ngưỡng (tính bằng giây) dùng để xác định thời điểm hệ thống ở trạng thái không hoạt động.
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 hoạt động, không hoạt động hoặc bị khoá. Sự kiện này kích hoạt với trạng thái "khoá" nếu màn hình bị khoá hoặc trình bảo vệ màn hình kích hoạt, "không hoạt động" nếu hệ thống được mở khoá và người dùng chưa tạo bất kỳ dữ liệu đầu vào nào trong số giây được chỉ định, và "đang hoạt động" khi người dùng tạo dữ liệu đầu vào trên hệ thống ở trạng thái rảnh.