chrome.power

תיאור

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

הרשאות

power

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

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

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

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

סוגים

Level

Enum

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

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

Methods

releaseKeepAwake()

chrome.power.releaseKeepAwake(): void

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

reportActivity()

Chrome 113 ואילך ‫ChromeOS בלבד
chrome.power.reportActivity(): Promise<void>

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

החזרות

  • Promise<void>

requestKeepAwake()

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

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

פרמטרים