browser.power

תיאור

משתמשים ב-API של chrome.power כדי לשנות את התכונות של ניהול צריכת החשמל במערכת.

הרשאות

power

מושגים ושימוש

כברירת מחדל, מערכות ההפעלה מעמעמות את המסך כשהמשתמשים לא פעילים, ובסופו של דבר משעות את המערכת. באמצעות ה-API של צריכת החשמל, אפליקציה או תוסף יכולים למנוע מהמערכת לעבור למצב שינה.

באמצעות ה-API הזה, אתם יכולים לציין את הרמה שבה ניהול צריכת החשמל מושבת. הרמה "system" משאירה את המערכת פעילה, אבל מאפשרת לעמעם או לכבות את המסך. לדוגמה, אפליקציית תקשורת יכולה להמשיך לקבל הודעות כשהמסך כבוי. הרמה "display" משאירה את המסך והמערכת פעילים. לדוגמה, אפליקציות של ספרים אלקטרוניים ומצגות יכולות להשאיר את המסך והמערכת פעילים בזמן שהמשתמשים קוראים.

כשלמשתמש יש יותר מאפליקציה או תוסף אחד פעילים, ולכל אחד מהם יש רמת הרשאה משלו, רמת ההרשאה עם הקדימות הגבוהה ביותר נכנסת לתוקף. "display" תמיד מקבלת קדימות על פני "system". לדוגמה, אם אפליקציה א' מבקשת ניהול צריכת חשמל של "system" ואפליקציה ב' מבקשת "display", המערכת תשתמש ב-"display" עד שאפליקציה ב' תפסיק לפעול או תבטל את הבקשה שלה. אם אפליקציה א' עדיין פעילה, המערכת משתמשת ב-"system".

סוגים

Level

טיפוסים בני מנייה (enum)

"system"
מונע מהמערכת לעבור למצב שינה בתגובה לחוסר פעילות של המשתמש.

"display"
מונע את כיבוי המסך או את העמעום שלו, או את המעבר של המערכת למצב שינה בתגובה לחוסר פעילות של המשתמש.

Methods

releaseKeepAwake()

browser.power.releaseKeepAwake(): void

מבטל בקשה קודמת שבוצעה באמצעות requestKeepAwake()‎.

reportActivity()

‫Chrome מגרסה 113 ואילך ‫browser.* ‎ מגרסה 148 של Chrome ‫ChromeOS בלבד 
browser.power.reportActivity(): Promise<void>

דיווח על פעילות משתמש כדי להעיר את המסך ממצב מעומעם או כבוי או משומר מסך. יציאה משומר המסך אם הוא פעיל כרגע.

החזרות

  • Promise<void>

requestKeepAwake()

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

בקשות להשבתה זמנית של ניהול צריכת החשמל. ההגדרה level מתארת את המידה שבה צריך להשבית את ניהול צריכת החשמל. אם בקשה קודמת של אותה אפליקציה עדיין פעילה, היא תוחלף בבקשה החדשה.

פרמטרים