คำอธิบาย
ใช้ chrome.idle
API เพื่อตรวจหาเมื่อสถานะไม่มีการใช้งานของเครื่องเปลี่ยนไป
สิทธิ์
idle
คุณต้องประกาศสิทธิ์ "idle"
ในไฟล์ Manifest ของส่วนขยายเพื่อใช้ API ที่ไม่มีการใช้งาน เช่น
{
"name": "My extension",
...
"permissions": [
"idle"
],
...
}
ประเภท
IdleState
ค่าแจกแจง
วิธีการ
getAutoLockDelay()
chrome.idle.getAutoLockDelay(
callback?: function,
)
รับเวลาในหน่วยวินาทีจนกว่าจะล็อกหน้าจอโดยอัตโนมัติขณะไม่มีการใช้งาน แสดงผลระยะเวลาเป็นศูนย์หากไม่ได้ล็อกหน้าจอโดยอัตโนมัติ ปัจจุบันรองรับใน Chrome OS เท่านั้น
พารามิเตอร์
-
Callback
ฟังก์ชัน ไม่บังคับ
พารามิเตอร์
callback
มีลักษณะดังนี้(delay: number) => void
-
ล่าช้า
ตัวเลข
เวลาในหน่วยวินาทีจนกว่าจะล็อกหน้าจอโดยอัตโนมัติขณะไม่มีการใช้งาน ซึ่งจะเป็น 0 หากหน้าจอไม่ล็อกโดยอัตโนมัติ
-
การคืนสินค้า
-
คำมั่นสัญญา<number>
Chrome 116 ขึ้นไปManifest V3 ขึ้นไปรองรับคำสัญญา แต่จะใช้โค้ดเรียกกลับเพื่อความเข้ากันได้แบบย้อนหลัง คุณไม่สามารถใช้ทั้ง 2 ฟีเจอร์ในการเรียกใช้ฟังก์ชันเดียวกันได้ คำสัญญาจะยุติด้วยประเภทเดียวกันกับที่ส่งไปยังโค้ดเรียกกลับ
queryState()
chrome.idle.queryState(
detectionIntervalInSeconds: number,
callback?: function,
)
แสดงผล "ล็อก" หากระบบล็อกไว้ "ไม่มีการใช้งาน" หากผู้ใช้ไม่ได้สร้างอินพุตใดๆ ภายในจำนวนวินาทีที่ระบุ หรือ "มีการใช้งาน" ในกรณีอื่นๆ
พารามิเตอร์
-
detectionIntervalInSeconds
ตัวเลข
ระบบจะถือว่าไม่มีความเคลื่อนไหว หากเมื่อเวลาผ่านไป DetectIntervalInSeconds วินาทีนับตั้งแต่ตรวจพบอินพุตล่าสุดของผู้ใช้
-
Callback
ฟังก์ชัน ไม่บังคับ
พารามิเตอร์
callback
มีลักษณะดังนี้(newState: IdleState) => void
-
newState
-
การคืนสินค้า
-
Promise<IdleState>
Chrome 116 ขึ้นไปManifest V3 ขึ้นไปรองรับคำสัญญา แต่จะใช้โค้ดเรียกกลับเพื่อความเข้ากันได้แบบย้อนหลัง คุณไม่สามารถใช้ทั้ง 2 ฟีเจอร์ในการเรียกใช้ฟังก์ชันเดียวกันได้ คำสัญญาจะยุติด้วยประเภทเดียวกันกับที่ส่งไปยังโค้ดเรียกกลับ
setDetectionInterval()
chrome.idle.setDetectionInterval(
intervalInSeconds: number,
)
ตั้งช่วงเวลาเป็นวินาที ซึ่งใช้เพื่อกำหนดเมื่อระบบอยู่ในสถานะไม่มีการใช้งานสำหรับเหตุการณ์ onStateChanged ช่วงเวลาเริ่มต้นคือ 60 วินาที
พารามิเตอร์
-
intervalInSeconds
ตัวเลข
เกณฑ์เป็นวินาที ใช้เพื่อระบุว่าระบบอยู่ในสถานะไม่มีการใช้งานเมื่อใด
กิจกรรม
onStateChanged
chrome.idle.onStateChanged.addListener(
callback: function,
)
เริ่มทำงานเมื่อระบบเปลี่ยนเป็นสถานะใช้งานอยู่ ไม่มีการใ��้งาน หรือล็อก เหตุการณ์จะเริ่มทำงานโดยมีสถานะ "ล็อก" หากหน้าจอล็อกอยู่หรือโปรแกรมรักษาหน้าจอเปิดใช้งาน "ไม่มีการใช้งาน" หากระบบปลดล็อกอยู่และผู้ใช้ไม่ได้สร้างอินพุตใดๆ ตามจำนวนวินาทีที่ระบุ และ "ทำงาน" เมื่อผู้ใช้สร้างอินพุตในระบบเมื่อไม่มีการใช้งาน