chrome.idle

คำอธิบาย

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

สิทธิ์

idle

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

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

ประเภท

IdleState

Chrome 44 ขึ้นไป

ค่าแจกแจง

"ใช้งานอยู่"

"ไม่มีการใช้งาน"

"ล็อก"

เมธอด

getAutoLockDelay()

สัญญา Chrome 73 ขึ้นไป ChromeOS เท่านั้น 
chrome.idle.getAutoLockDelay(
  callback?: function,
)

รับข้อมูลเวลาเป็นวินาทีที่ใช้จนกระทั่งหน้าจอล็อกโดยอัตโนมัติขณะไม่มีการใช้งาน แสดงระยะเวลาเป็น 0 หากระบบไม่ล็อกหน้าจอโดยอัตโนมัติ ขณะนี้รองรับเฉพาะ Chrome OS เท่านั้น

พารามิเตอร์

  • Callback

    ไม่บังคับ

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

    (delay: number) => void

    • ล่าช้า

      ตัวเลข

      เวลาเป็นวินาทีก่อนที่หน้าจอจะล็อกโดยอัตโนมัติขณะไม่มีการใช้งาน หากหน้าจอไม่ล็อกโดยอัตโนมัติ ค่าจะเป็น 0

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

  • Promise<number>

    Chrome 116 ขึ้นไป

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

queryState()

สัญญา 
chrome.idle.queryState(
  detectionIntervalInSeconds: number,
  callback?: function,
)

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

พารามิเตอร์

  • detectionIntervalInSeconds

    ตัวเลข

    ระบบจะถือว่าไม่มีความเคลื่อนไหวหากพ้นจาก DetectionIntervalInSeconds วินาทีนับตั้งแต่ที่ตรวจพบอินพุตของผู้ใช้ล่าสุด

  • Callback

    ไม่บังคับ

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

    (newState: IdleState) => void

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

  • Promise<IdleState>

    Chrome 116 ขึ้นไป

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

setDetectionInterval()

chrome.idle.setDetectionInterval(
  intervalInSeconds: number,
)

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

พารามิเตอร์

  • intervalInSeconds

    ตัวเลข

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

กิจกรรม

onStateChanged

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

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

พารามิเตอร์

  • Callback

    ฟังก์ชัน

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

    (newState: IdleState) => void