хром.мощность

Описание

Используйте API chrome.power для переопределения функций управления питанием системы.

Разрешения

power

Использование

По умолчанию операционные системы затемняют экран, когда пользователи неактивны, и в конечном итоге приостанавливают работу системы. С помощью API Power приложение или расширение может поддерживать систему в активном состоянии.

С помощью этого API можно указать уровень , на котором будет отключено управление питанием. Уровень "system" сохраняет систему активной, но позволяет уменьшить яркость экрана или отключить его. Например, приложение для общения может продолжать получать сообщения при выключенном экране. Уровень "display" поддерживает экран и систему активными. Например, приложения для чтения электронных книг и презентаций могут поддерживать экран и систему активными во время чтения.

Если у пользователя активно несколько приложений или расширений, каждое из которых имеет свой уровень энергопотребления, применяется уровень с наивысшим приоритетом; "display" всегда имеет приоритет над "system" . Например, если приложение A запрашивает управление энергопотреблением "system" , а приложение B запрашивает "display" , используется "display" до тех пор, пока приложение B не будет выгружено или не отменит свой запрос. Если приложение A всё ещё активно, используется "system" .

Типы

Level

Перечисление

"система"
Предотвращает переход системы в спящий режим в ответ на бездействие пользователя.

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

Методы

releaseKeepAwake()

chrome.power.releaseKeepAwake(): void

Освобождает запрос, ранее сделанный с помощью requestKeepAwake().

reportActivity()

Обещаем Chrome 113+ только для ChromeOS
chrome.power.reportActivity(
  callback?: function,
): Promise<void>

Сообщает об активности пользователя, чтобы вывести экран из затемнённого или выключенного состояния, а также из состояния заставки. Выключает заставку, если она активна.

Параметры

  • перезвонить

    функция необязательна

    Параметр callback выглядит так: 

    () => void

Возврат

  • Обещание<void>

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

requestKeepAwake()

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

Запрашивает временное отключение управления питанием. level определяет степень отключения управления питанием. Если запрос, отправленный ранее тем же приложением, всё ещё активен, он будет заменён новым запросом.

Параметры