chrome.idle

คำอธิบาย

ใช้ chrome.idle API เพื่อตรวจหาเมื่อสถานะไม่มีการใช้งานของเครื่องเปลี่ยนไป

สิทธิ์

idle

คุณต้องประกาศสิทธิ์ "idle" ในไฟล์ Manifest ของส่วนขยายเพื่อใช้ API ที่ไม่มีการใช้งาน เช่น

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

ประเภท

IdleState

Chrome 44 ขึ้นไป

ค่าแจกแจง

วิธีการ

getAutoLockDelay()

Promise Chrome 73 ขึ้นไป ChromeOS เท่านั้น 
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

การคืนสินค้า

  • Promise<IdleState>

    Chrome 116 ขึ้นไป

    Manifest V3 ขึ้นไปรองรับคำสัญญา แต่จะใช้โค้ดเรียกกลับเพื่อความเข้ากันได้แบบย้อนหลัง คุณไม่สามารถใช้ทั้ง 2 ฟีเจอร์ในการเรียกใช้ฟังก์ชันเดียวกันได้ คำสัญญาจะยุติด้วยประเภทเดียวกันกับที่ส่งไปยังโค้ดเรียกกลับ

setDetectionInterval()

chrome.idle.setDetectionInterval(
  intervalInSeconds: number,
)

ตั้งช่วงเวลาเป็นวินาที ซึ่งใช้เพื่อกำหนดเมื่อระบบอยู่ในสถานะไม่มีการใช้งานสำหรับเหตุการณ์ onStateChanged ช่วงเวลาเริ่มต้นคือ 60 วินาที

พารามิเตอร์

  • intervalInSeconds

    ตัวเลข

    เกณฑ์เป็นวินาที ใช้เพื่อระบุว่าระบบอยู่ในสถานะไม่มีการใช้งานเมื่อใด

กิจกรรม

onStateChanged

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

เริ่มทำงานเมื่อระบบเปลี่ยนเป็นสถานะใช้งานอยู่ ไม่มีการใช้งาน หรือล็อก เหตุการณ์จะเริ่มทำงานโดยมีสถานะ "ล็อก" หากหน้าจอล็อกอยู่หรือโปรแกรมรักษาหน้าจอเปิดใช้งาน "ไม่มีการใช้งาน" หากระบบปลดล็อกอยู่และผู้ใช้ไม่ได้สร้างอินพุตใดๆ ตามจำนวนวินาทีที่ระบุ และ "ทำงาน" เมื่อผู้ใช้สร้างอินพุตในระบบเมื่อไม่มีการใช้งาน

พารามิเตอร์

  • Callback

    ฟังก์ชัน

    พารามิเตอร์ callback มีลักษณะดังนี้ 

    (newState: IdleState)=>void