chrome.power

Beschreibung

Verwenden Sie die chrome.power API, um die Funktionen zur Energieverwaltung des Systems zu überschreiben.

Berechtigungen

power

Konzepte und Nutzung

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

Mit dieser API können Sie die Ebene festlegen, auf der die Energieverwaltung deaktiviert wird. Auf der Ebene "system" bleibt das System aktiv, ermöglicht aber das Dimmen oder Ausschalten des Bildschirms. So kann eine Kommunikations-App beispielsweise weiterhin Nachrichten empfangen, während der Bildschirm ausgeschaltet ist. Auf der "display"-Ebene bleiben Bildschirm und 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 mehr als eine App oder Erweiterung mit jeweils eigenem Energielevel aktiv hat, gilt die höchste Prioritätsstufe. "display" hat immer Vorrang vor "system". Wenn App A beispielsweise die Energieverwaltung für "system" anfordert und App B nach "display" fragt, wird "display" verwendet, bis App B entladen wird oder die Anfrage freigibt. Wenn Anwendung A noch aktiv ist, wird "system" verwendet.

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 das System bei Inaktivität des Nutzers in den Ruhemodus wechselt.

Methoden

releaseKeepAwake()

chrome.power.releaseKeepAwake()

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

reportActivity()

Versprechen Chrome 113 oder höher Nur ChromeOS 
chrome.power.reportActivity(
  callback?: function,
)

Meldet eine Nutzeraktivität, um den Bildschirm aus einem abgedunkelten oder ausgeschalteten Zustand oder mit einem Bildschirmschoner zu aktivieren. Schließt den Bildschirmschoner, wenn er gerade aktiv ist.

Parameters

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    ()=>void

Rückgaben

  • Promise<void>

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

requestKeepAwake()

chrome.power.requestKeepAwake(
  level: Level,
)

Fordert an, dass die Energieverwaltung vorübergehend deaktiviert wird. level beschreibt, zu welchem Grad die Energieverwaltung deaktiviert werden sollte. Wenn eine Anfrage, die zuvor von derselben App gestellt wurde, noch aktiv ist, wird sie durch die neue Anfrage ersetzt.

Parameters