chrome.power

Beschreibung

Mit der chrome.power API können Sie die Energieverwaltungsfunktionen des Systems überschreiben.

Berechtigungen

power

Konzepte und Verwendung

Standardmäßig wird der Bildschirm von Betriebssystemen abgedunkelt, wenn Nutzer inaktiv sind, und das System wird schließlich in den Ruhezustand versetzt. Mit der Power API kann eine App oder Erweiterung das System aktiv halten.

Mit dieser API können Sie die Ebene angeben, auf der die Energieverwaltung deaktiviert wird. Auf der "system"-Ebene bleibt das System aktiv, aber das Display kann gedimmt oder ausgeschaltet werden. So kann eine Kommunikations-App beispielsweise weiterhin Nachrichten empfangen, während das Display ausgeschaltet ist. Auf der "display"-Ebene bleiben das Display und das System aktiv. E‑Book- und Präsentations-Apps können beispielsweise den Bildschirm und das System aktiv halten, während Nutzer lesen.

Wenn ein Nutzer mehrere Apps oder Erweiterungen mit jeweils eigener Priorität aktiviert hat, gilt die Priorität mit der höchsten Priorität. "display" hat immer Vorrang vor "system". Wenn App A beispielsweise "system" anfordert und App B "display", wird "display" verwendet, bis App B entladen wird oder die Anfrage freigibt. Wenn App A noch aktiv ist, wird "system" verwendet.

Typen

Level

Enum

„system“
Verhindert, dass das System aufgrund von Nutzerinaktivität in den Ruhemodus wechselt.

„display“
Verhindert, dass das Display aufgrund von Nutzerinaktivität ausgeschaltet oder gedimmt wird oder das System in den Ruhemodus wechselt.

Methoden

releaseKeepAwake()

chrome.power.releaseKeepAwake(): void

Gibt eine zuvor über requestKeepAwake() gestellte Anfrage frei.

reportActivity()

Chrome 113 und höher Nur ChromeOS 
chrome.power.reportActivity(): Promise<void>

Meldet eine Nutzeraktivität, um den Bildschirm aus einem abgedunkelten oder ausgeschalteten Zustand oder aus einem Bildschirmschoner zu reaktivieren. Beendet den Bildschirmschoner, falls er gerade aktiv ist.

Ausgabe

  • Promise<void>

requestKeepAwake()

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

Anfragen, die die temporäre Deaktivierung der Energieverwaltung betreffen. level beschreibt, in welchem Umfang die Energieverwaltung deaktiviert werden soll. Wenn eine zuvor von derselben App gestellte Anfrage noch aktiv ist, wird sie durch die neue Anfrage ersetzt.

Parameter