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 gedimmt, wenn Nutzer inaktiv sind, und sperren den System. Mit der Power API kann eine App oder Erweiterung das System aktiv halten.

Mit dieser API können Sie den Level angeben, auf den die Energieverwaltung deaktiviert werden soll. Das "system" aktiviert, lässt aber zu, dass der Bildschirm gedimmt oder ausgeschaltet wird. Beispiel: Die Kommunikations-App kann auch bei ausgeschaltetem Bildschirm weiterhin Nachrichten empfangen. Ebene "display" dass Bildschirm und System aktiv bleiben. So können z. B. E-Books und Präsentations-Apps den Bildschirm und das System aktiv ist, während die Nutzer lesen.

Hat ein Nutzer mehrere aktive Apps oder Erweiterungen mit jeweils unterschiedlicher Energiestufe, die höchste Priorität wirksam wird. "display" hat immer Vorrang vor "system". Für Beispiel: App A fragt nach der Energieverwaltung "system" und App B nach "display", "display" wird verwendet, bis App B entladen wird oder ihre Anfrage freigibt. Wenn App A noch aktiv ist, ist "system" dann verwendet werden.

Typen

Level

Enum

"system"
Verhindert, dass das System bei Inaktivität des Nutzers in den Ruhemodus wechselt.

"display"
Verhindert, dass das Display ausgeschaltet oder gedimmt wird oder dass das System bei Inaktivität in den Ruhemodus wechselt.

Methoden

releaseKeepAwake()

chrome.power.releaseKeepAwake()

Gibt eine Anfrage frei, die zuvor über requestKeepAwake() gestellt wurde.

reportActivity()

<ph type="x-smartling-placeholder"></ph> Versprechen Chrome 113 und höher Nur ChromeOS 
chrome.power.reportActivity(
  callback?: function,
)

Meldet eine Nutzeraktivität, um den Bildschirm aus einem abgeblendeten oder deaktivierten Zustand oder einem Bildschirmschoner zu wecken. Beendet den Bildschirmschoner, wenn er gerade aktiv ist.

Parameter

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    () => void

Returns

  • Versprechen<void>

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

requestKeepAwake()

chrome.power.requestKeepAwake(
  level: Level,
)

Anfrage zur vorübergehenden Deaktivierung der Energieverwaltung level gibt an, inwieweit die Energieverwaltung deaktiviert werden soll. Wenn eine Anfrage, die zuvor von derselben App gestellt wurde, noch aktiv ist, wird sie durch die neue Anfrage ersetzt.

Parameter