chrome.power

תיאור

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

הרשאות

power

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

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

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

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

סוגים

Level

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

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

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

שיטות

releaseKeepAwake()

chrome.power.releaseKeepAwake()

משחרר בקשה שבוצעה בעבר דרך requestKeepAwake().

reportActivity()

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

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

פרמטרים

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

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

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

    ()=>void

החזרות

  • Promise<void>

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

requestKeepAwake()

chrome.power.requestKeepAwake(
  level: Level,
)

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

פרמטרים