chrome.power

refresh date: 2026-09-25 robots: noindex

คำอธิบาย

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

สิทธิ์

power

การใช้งาน

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

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

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

ประเภท

Level

ค่าแจกแจง

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

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

เมธอด

releaseKeepAwake()

chrome.power.releaseKeepAwake(): void

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

reportActivity()

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

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

พารามิเตอร์

  • callback

    function ไม่บังคับ

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

    () => void

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

  • Promise<void>

    ระบบรองรับ Promise สำหรับ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้ Callback

requestKeepAwake()

chrome.power.requestKeepAwake(
  level: Level,
)
: void

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

พารามิเตอร์