DieWakeLockSentinel-Schnittstelle derScreen Wake Lock API kann verwendet werden, um den Status der Plattform-Bildschirmwachschaltung zu überwachen und bei Bedarf den Lock manuell zu lösen.

Die Bildschirmwachschaltung verhindert, dass Geräteschirme gedimmt oder gesperrt werden, wenn eine Anwendung weiterlaufen muss.

Ein Bildschirm-Wachschaltung wird mit der Methodenavigator.wakeLock.request() angefordert, die einPromise zurückgibt, das mit einemWakeLockSentinel-Objekt erfüllt wird, wenn der Lock gewährt wird.

Ein erworbener Bildschirm-Wachschaltung kann manuell über die Methoderelease() oder automatisch über die Plattform-Bildschirmwachschaltung gelöst werden. Letzteres kann geschehen, wenn das Dokument inaktiv wird oder die Sichtbarkeit verliert, wenn das Gerät wenig Strom hat oder der Benutzer den Energiesparmodus aktiviert.Ein freigegebenerWakeLockSentinel kann nicht wiederverwendet werden: Ein neuer Sentinel muss mitnavigator.wakeLock.request() angefordert werden, wenn ein neuer Lock benötigt wird.Das Freigeben allerWakeLockSentinel-Instanzen eines bestimmten Typs von Wachschaltung führt dazu, dass der zugrunde liegende Plattform-Lock gelöst wird.

Ein Ereignis wird an denWakeLockSentinel ausgelöst, wenn der Plattform-Lock gelöst wird, sodass Anwendungen ihre Benutzeroberfläche entsprechend konfigurieren und, falls erforderlich, den Lock erneut anfordern können.

Instanzeigenschaften

Erbt auch Eigenschaften von seiner Elternschnittstelle,EventTarget.

releasedSchreibgeschützt

Gibt einen Booleschen Wert zurück, der anzeigt, ob derWakeLockSentinel freigegeben wurde.

typeSchreibgeschützt

Gibt eine Zeichenkettenrepräsentation des derzeit erworbenenWakeLockSentinel-Typs zurück.Rückgabewerte sind:

• screen: Eine Bildschirm-Wachschaltung.Verhindert, dass Geräte den Bildschirm dimmen oder sperren.

Instanzmethoden

Erbt auch Methoden von seiner Elternschnittstelle,EventTarget.

release()

Löst denWakeLockSentinel und gibt einPromise zurück, das aufgelöst wird, sobald der Sentinel erfolgreich freigegeben wurde.

Ereignisse

release

Wird ausgelöst, wenn die Methoderelease() aufgerufen wird oder der Wachschaltung vom Benutzer-Agent freigegeben wird.

Beispiele

In diesem Beispiel erstellen wir eine asynchrone Funktion, die einenWakeLockSentinel anfordert.Sobald die Bildschirm-Wachschaltung erlangt ist, lauschen wir demrelease-Ereignis, das verwendet werden kann, um entsprechendes UI-Feedback zu geben.Der Sentinel kann durch entsprechende Interaktionen erworben oder freigegeben werden.

// create a reference for the wake locklet wakeLock = null;// create an async function to request a wake lockconst requestWakeLock = async () => {  try {    wakeLock = await navigator.wakeLock.request("screen");    // listen for our release event    wakeLock.addEventListener("release", () => {      // if wake lock is released alter the UI accordingly    });  } catch (err) {    // if wake lock request fails - usually system related, such as battery  }};wakeLockOnButton.addEventListener("click", () => {  requestWakeLock();});wakeLockOffButton.addEventListener("click", () => {  if (wakeLock !== null) {    wakeLock.release().then(() => {      wakeLock = null;    });  }});

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Stay awake with the Screen Wake Lock API