browser.idle

คำอธิบาย

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

สิทธิ์

idle

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

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

ประเภท

IdleState

Chrome 44 ขึ้นไป browser.* ตั้งแต่ Chrome 148

ค่าแจกแจง

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

"idle"

"ล็อก"

เมธอด

getAutoLockDelay()

Chrome 73 ขึ้นไป browser.* ตั้งแต่ Chrome 148 ChromeOS เท่านั้น

browser.idle.getAutoLockDelay(): Promise<number>

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

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

• Promise<number>

  Chrome 116 ขึ้นไป browser.* ตั้งแต่ Chrome 148

queryState()

browser.idle.queryState(
  detectionIntervalInSeconds: number,
): Promise<IdleState>

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

พารามิเตอร์

• detectionIntervalInSeconds

  ตัวเลข

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

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

• Promise<IdleState>

  Chrome 116 ขึ้นไป browser.* ตั้งแต่ Chrome 148

setDetectionInterval()

browser.idle.setDetectionInterval(
  intervalInSeconds: number,
): void

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

พารามิเตอร์

• intervalInSeconds

  ตัวเลข

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

กิจกรรม

onStateChanged

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

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

พารามิเตอร์

• callback

  ฟังก์ชัน

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

  (newState: IdleState) => void

  • newState

    IdleState