chrome.power

คำอธิบาย

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

สิทธิ์

power

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

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

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

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

ประเภท

Level

ค่าแจกแจง

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

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

วิธีการ

releaseKeepAwake()

chrome.power.releaseKeepAwake()

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

reportActivity()

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

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

พารามิเตอร์

  • Callback

    ฟังก์ชัน ไม่บังคับ

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

    ()=>void

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

  • Promise<void>

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

requestKeepAwake()

chrome.power.requestKeepAwake(
  level: Level,
)

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

พารามิเตอร์