chrome.power

คำอธิบาย

ใช้ chrome.power API เพื่อลบล้างฟีเจอร์การจัดการพลังงานของระบบ

สิทธิ์

power

แนวคิดและการใช้งาน

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

เมื่อใช้ API นี้ คุณจะระบุ Level ที่จะปิดใช้การจัดการพลังงานได้ "system" จะทำให้ระบบทำงานตลอดเวลา แต่สามารถหรี่แสงหน้าจอหรือปิดหน้าจอได้ ตัวอย่างเช่น แอปการสื่อสารจะยังคงรับข้อความต่อไปได้ขณะที่หน้าจอปิดอยู่ ระดับ "display" ทำให้หน้าจอและระบบทำงานอยู่ตลอดเวลา เช่น แอป eBook และงานนำเสนอจะช่วยให้หน้าจอ และระบบทำงานขณะผู้ใช้อ่าน

เมื่อผู้ใช้มีแอปหรือส่วนขยายที่ใช้งานอยู่มากกว่า 1 รายการ โดยแต่ละรายการจะมีระดับพลังงานเป็นของตัวเอง ลำดับความสำคัญสูงสุดจะมีผล "display" จะมีความสำคัญเหนือ "system" เสมอ สำหรับ เช่น หากแอป A ขอการจัดการพลังงานของ "system" และแอป B ถามหา "display", "display" จะถูกใช้จนกว่าแอป B จะถูกยกเลิกโหลดหรือเผยแพร่คำขอ หากแอป A ยังทำงานอยู่ "system" จะ จากนั้นใช้

ประเภท

Level

ค่าแจกแจง

"system"
ป้องกันไม่ให้ระบบเข้าสู่โหมดสลีปเมื่อผู้ใช้ไม่มีการใช้งาน

"display"
ป้องกันไม่ให้หน้าจอปิดหรือหรี่แสง หรือให้ระบบเข้าสู่โหมดสลีปเมื่อผู้ใช้ไม่มีการใช้งาน

เมธอด

releaseKeepAwake()

chrome.power.releaseKeepAwake()

ปล่อยคำขอที่ส่งก่อนหน้านี้ผ่าน requestKeepAwake()

reportActivity()

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

รายงานกิจกรรมของผู้ใช้เพื่อปลุกหน้าจอจากสถานะหรี่แสงหรือปิด หรือจากภาพพักหน้าจอ ออกจากโปรแกรมรักษาหน้าจอหากทำงานอยู่

พารามิเตอร์

  • Callback

    ไม่บังคับ

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

    () => void

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

  • คำมั่นสัญญา<โมฆะ>

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

requestKeepAwake()

chrome.power.requestKeepAwake(
  level: Level,
)

คำขอให้ปิดใช้การจัดการพลังงานชั่วคราว level อธิบายระดับที่ควรปิดใช้การจัดการพลังงาน หากคำขอที่แอปเดิมสร้างไว้ก่อนหน้านี้ยังคงทำงานอยู่ ระบบจะแทนที่คำขอนั้นด้วยคำขอใหม่

พารามิเตอร์