chrome.power

תיאור

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

הרשאות

power

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

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

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

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

סוגים

Level

Enum

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

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

שיטות

releaseKeepAwake()

chrome.power.releaseKeepAwake()

משחררת בקשה שנשלחה בעבר באמצעות requestKeepKeepAwake().

reportActivity()

הבטחה Chrome 113 ואילך ChromeOS בלבד 
chrome.power.reportActivity(
  callback?: function,
)

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

פרמטרים

  • קריאה חוזרת (callback)

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

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

    () => void

החזרות

  • הבטחה<Empty>

    הבטחות נתמכות במניפסט מגרסה V3 ואילך, אבל ניתנות קריאות חוזרות (callback) בשביל תאימות לאחור. לא ניתן להשתמש בשתיהן באותה בקשה להפעלת פונקציה. ההבטחה הזו מצליחה לפתור את הבעיה באותו סוג שמועבר לקריאה החוזרת.

requestKeepAwake()

chrome.power.requestKeepAwake(
  level: Level,
)

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

פרמטרים