WakeLockSentinel

Интерфейс WakeLockSentinel API Блокировки экрана может использоваться для мониторинга состояния блокировки экрана платформы и ручного отключения блокировки при необходимости.

Блокировка экрана предотвращает затемнение или блокировку экрана устройства, когда приложение должно продолжать работу.

Блокировка экрана запрашивается с помощью метода navigator.wakeLock.request(), который возвращает Promise, который выполняется с объектом WakeLockSentinel, если блокировка предоставлена.

Полученную блокировку экрана можно вручную отключить через метод release() или автоматически через блокировку экрана платформы. Последнее может произойти, если документ станет неактивным или потеряет видимость, если устройство испытывает низкий уровень заряда или если пользователь включил режим экономии энергии. Освобожденный WakeLockSentinel не может быть повторно использован: новый сентиннель должен быть запрошен с помощью navigator.wakeLock.request(), если нужна новая блокировка. Отключение всех WakeLockSentinel экземпляров данного типа блокировки приведет к отключению базовой блокировки платформы.

При отключении платформенной блокировки на WakeLockSentinel генерируется событие, позволяющее приложениям настроить свой интерфейс и повторно запросить блокировку при необходимости.

Также наследует свойства от родительского интерфейса EventTarget.

released Только для чтения

Возвращает значение булевого типа, указывающее, была ли WakeLockSentinel освобождена.

type Только для чтения

Возвращает строковое представление текущего типа приобретённой WakeLockSentinel. Возможные значения:

• screen: Блокировка экрана. Предотвращает затемнение или блокировку экрана устройств.

Также наследует методы от родительского интерфейса EventTarget.

release()

Освобождает WakeLockSentinel, возвращая Promise, который разрешается после успешного освобождения сентиннеля.

release

Срабатывает, когда вызывается метод release() или блокировка экрана отключается пользователем.

В этом примере мы создаём асинхронную функцию, которая запрашивает WakeLockSentinel. После того, как блокировка экрана будет получена, мы слушаем событие release, которое можно использовать для соответствующей обратной связи в пользовательском интерфейсе. Сентиннель можно получить или освободить с помощью соответствующих взаимодействий.

// create a reference for the wake lock
let wakeLock = null;

// create an async function to request a wake lock
const 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;
    });
  }
});

• Оставайтесь активными с API блокировки экрана