chrome.power

Opis

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

Uprawnienia

power

Pojęcia i zastosowanie

Domyślnie systemy operacyjne przyciemniają ekran, gdy użytkownicy są nieaktywni, a następnie wstrzymują działanie systemu. Dzięki interfejsowi Power API 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 system w stanie aktywności, 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 ekran i system w stanie aktywności. Na przykład aplikacje do czytania e-booków i prezentacji mogą utrzymywać aktywność ekranu i systemu podczas czytania.

Jeśli użytkownik ma aktywne więcej niż 1 aplikację lub rozszerzenie, z których każde ma własny poziom zasilania, obowiązuje poziom o najwyższym priorytecie. "display" zawsze ma wyższy priorytet niż "system". Jeśli na przykład aplikacja A prosi o "system" zarządzanie energią, a aplikacja B prosi o "display", "display" jest używane do momentu, gdy aplikacja B zostanie zwolniona lub wycofa swoją prośbę. Jeśli aplikacja A jest nadal aktywna, używany jest znak "system".

Typy

Level

Typ wyliczeniowy

„system”
Zapobiega przechodzeniu systemu w stan uśpienia w odpowiedzi na brak aktywności użytkownika.

„display”
Zapobiega wyłączeniu lub przyciemnieniu ekranu oraz przejściu systemu w stan uśpienia w odpowiedzi na brak aktywności użytkownika.

Metody

releaseKeepAwake()

chrome.power.releaseKeepAwake(): void

Zwalnia żądanie zgłoszone wcześniej za pomocą metody requestKeepAwake().

reportActivity()

Chrome w wersji 113 lub nowszej Tylko ChromeOS
chrome.power.reportActivity(): Promise<void>

Raportuje aktywność użytkownika w celu wybudzenia ekranu z przyciemnionego lub wyłączonego stanu albo z wygaszacza ekranu. Wyłącza wygaszacz ekranu, jeśli jest aktywny.

Zwroty

  • Promise<void>

requestKeepAwake()

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

Żądania tymczasowego wyłączenia zarządzania energią. level określa stopień, w jakim zarządzanie energią 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