chrome.power

תאריך הרענון: 2026-09-25 robots: noindex

תיאור

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

הרשאות

power

שימוש

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

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

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

סוגים

Level

ספירה

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

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

Methods

releaseKeepAwake()

chrome.power.releaseKeepAwake(): void

הפונקציה מבטלת בקשה שהוגשה בעבר באמצעות requestKeepAwake().

reportActivity()

Promise Chrome 113+ ChromeOS only
chrome.power.reportActivity(
  callback?: function,
)
: Promise<void>

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

פרמטרים

  • callback

    פונקציה אופציונלית

    הפרמטר callback נראה כך:

    () => void

החזרות

  • Promise<void>

    התמיכה ב-Promises קיימת רק ב-Manifest V3 ואילך. בפלטפורמות אחרות צריך להשתמש ב-callbacks.

requestKeepAwake()

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

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

פרמטרים