chrome.power

Opis

Aby zastąpić funkcje zarządzania zasilaniem systemu, użyj interfejsu API chrome.power.

Uprawnienia

power

Pojęcia i wykorzystanie

Domyślnie systemy operacyjne przyciemniają ekran, gdy użytkownicy są nieaktywni, a następnie 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. "system" utrzymuje aktywność systemu, ale umożliwia przyciemnienie lub wyłączenie ekranu. Na przykład plik aplikacja do komunikacji może nadal odbierać wiadomości, nawet gdy ekran jest wyłączony. Poziom "display" utrzymuje aktywność ekranu i systemu. Na przykład aplikacje do obsługi e-booków i prezentacji mogą a system jest aktywny w trakcie czytania przez użytkowników.

Jeśli użytkownik ma aktywnych więcej niż jedną aplikację lub rozszerzenie z własnym poziomem uprawnień, ma najwyższy priorytet; Parametr "display" ma zawsze pierwszeństwo przed zasadą "system". Dla: jeśli na przykład aplikacja A prosi o zarządzanie energią w trybie "system", a aplikacja B prosi o "display", "display" jest używany do momentu wyładowania aplikacji B lub wydania swojego żądania. Jeśli aplikacja A jest nadal aktywna, "system" to i dane.

Typy

Level

Typ wyliczeniowy

"system"
Zapobiega przechodzeniu systemu w reakcji na brak aktywności użytkownika.

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

Metody

releaseKeepAwake()

chrome.power.releaseKeepAwake()

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

reportActivity()

Obietnica Chrome w wersji 113 lub nowszej Tylko ChromeOS .
chrome.power.reportActivity(
  callback?: function,
)

Zgłasza aktywność użytkownika, która ma na celu wybudzenie ekranu z wyłączonego lub przyciemnionego lub wyłączonego ekranu albo po użyciu wygaszacza ekranu. Zamyka wygaszacz ekranu, jeśli jest aktywny.

Parametry

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak:

    () => void
    .

Zwroty

  • Obietnica<void>

    Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.

requestKeepAwake()

chrome.power.requestKeepAwake(
  level: Level,
)

Żądania wymagające tymczasowego wyłączenia zarządzania energią. level opisuje, w jakim stopniu należy wyłączyć zarządzanie energią. Jeśli prośba wysłana wcześniej przez tę samą aplikację jest nadal aktywna, zostanie zastąpiona nową.

Parametry