browser.power

Opis

Użyj interfejsu API chrome.power, aby zastąpić funkcje zarządzania energią systemu.

Uprawnienia

power

Pojęcia i użycie

Domyślnie systemy operacyjne przyciemniają ekran, gdy użytkownicy są nieaktywni, i ostatecznie zawieszają system. Dzięki interfejsowi API zasilania aplikacja lub rozszerzenie może utrzymywać system w stanie aktywności.

Za pomocą tego interfejsu API możesz określić poziom, na którym zarządzanie energią jest wyłączone. Poziom "system" utrzymuje aktywność systemu, ale pozwala na przyciemnienie lub wyłączenie ekranu. Na przykład aplikacja do komunikacji może nadal odbierać wiadomości, gdy ekran jest wyłączony. Poziom "display" utrzymuje aktywność ekranu i systemu. Na przykład aplikacje do e-booków i prezentacji mogą utrzymywać ekran i system w stanie aktywnym, gdy użytkownicy czytają.

Jeśli użytkownik ma więcej niż 1 aktywną aplikację lub rozszerzenie, z których każda ma własny poziom uprawnień, obowiązuje poziom o najwyższym priorytecie. "display" zawsze ma pierwszeństwo przed "system". Jeśli na przykład aplikacja A żąda zarządzania zasilaniem "system", a aplikacja B żąda "display", używane jest "display", dopóki aplikacja B nie zostanie wyładowana lub nie wycofa żądania. Jeśli aplikacja A jest nadal aktywna, używana jest wartość "system".

Typy

Level

Typ wyliczeniowy

"system"
Uniemożliwia przejście systemu w tryb uśpienia, gdy użytkownik jest nieaktywny.

"display"
Zapobiega wyłączeniu lub przyciemnieniu wyświetlacza albo uśpieniu systemu w przypadku braku aktywności użytkownika.

Metody

releaseKeepAwake()

browser.power.releaseKeepAwake(): void

Zwalnia żądanie wysłane wcześniej za pomocą funkcji requestKeepAwake().

reportActivity()

Chrome 113 lub nowsza wersja browser.* od Chrome 148 Tylko ChromeOS 
browser.power.reportActivity(): Promise<void>

Zgłasza aktywność użytkownika, aby wybudzić ekran ze stanu przyciemnienia lub wyłączenia albo z wygaszacza ekranu. Zamyka wygaszacz ekranu, jeśli jest on obecnie aktywny.

Zwroty

  • thought Promise<void>

requestKeepAwake()

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

Żąda tymczasowego wyłączenia zarządzania zasilaniem. level określa stopień, w jakim zarządzanie zasilaniem powinno być wyłączone. Jeśli prośba wysłana wcześniej przez tę samą aplikację jest nadal aktywna, zostanie zastąpiona nową prośbą.

Parametry