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

Описание

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

Разрешения

power

Концепции и использование

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

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

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

Типы

Level

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

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

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

Методы

releaseKeepAwake()

chrome.power.releaseKeepAwake()

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

reportActivity()

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

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

Параметры

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

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

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

    () => void

Возврат

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

    Промисы поддерживаются в Манифесте V3 и более поздних версиях, но обратные вызовы предусмотрены для обратной совместимости. Вы не можете использовать оба при одном вызове функции. Промис разрешается с тем же типом, который передается в обратный вызов.

requestKeepAwake()

chrome.power.requestKeepAwake(
  level: Level,
)

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

Параметры