chrome.power

Opis

Zastępowanie funkcji zarządzania energią systemu za pomocą interfejsu API chrome.power.

Uprawnienia

power

Pojęcia i zastosowanie

Domyślnie systemy operacyjne przyciemniają ekran, gdy użytkownicy są nieaktywni, i w ostatecznym rozrachunku zawiesza system. Dzięki interfejsowi Power API aplikacja lub rozszerzenie może utrzymywać system w trybie uśpienia.

Przy użyciu tego interfejsu API możesz określić Poziom, na którym zarządzanie energią ma być wyłączone. Poziom "system" utrzymuje system aktywny, ale umożliwia przyciemnienie lub wyłączenie ekranu. Na przykład aplikacja do komunikacji może nadal otrzymywać wiadomości, gdy ekran jest wyłączony. Poziom "display" utrzymuje ekran i system. Na przykład aplikacje do obsługi e-booków i prezentacji mogą utrzymywać aktywność ekranu i systemu, gdy użytkownicy czytają.

Gdy użytkownik ma więcej niż 1 aktywną aplikację lub rozszerzenie, z których każda ma własny poziom zasilania, obowiązuje najwyższy poziom priorytetu. "display" zawsze ma pierwszeństwo przed zasadą "system". Jeśli na przykład aplikacja A prosi o zarządzanie energią w trybie "system", a aplikacja B – "display", używany jest parametr "display", dopóki aplikacja B nie zostanie wyładowana z pamięci lub nie udostępni swojego żądania. Jeśli aplikacja A jest nadal aktywna, używana jest "system".

Typy

Level

Enum

"system"
Zapobiega uśpieniu systemu w odpowiedzi na brak aktywności użytkownika.

"display"
Zapobiega wyłączeniu i przyciemnianiu ekranu oraz uśpieniu systemu w odpowiedzi na brak aktywności użytkownika.

Metody

releaseKeepAwake()

chrome.power.releaseKeepAwake()

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

reportActivity()

Obietnica Chrome 113 i nowsze wersje Tylko ChromeOS 
chrome.power.reportActivity(
  callback?: function,
)

Raportuje aktywność użytkownika w celu wybudzenia ekranu po przyciemnieniu lub wyłączeniu bądź włączeniu wygaszacza ekranu. Zamyka wygaszacz ekranu, jeśli jest aktywny.

Parametry

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    ()=>void

Akcje powrotne

  • Promise<void>

    Obietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika z tym samym typem, który jest przekazywany do wywołania zwrotnego.

requestKeepAwake()

chrome.power.requestKeepAwake(
  level: Level,
)

Wysyła prośbę o tymczasowe wyłączenie 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ę będzie nadal aktywna, zostanie zastąpiona nową prośbą.

Parametry