chrome.power

refresh date: 2026-09-25 robots: noindex

Opis

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

Uprawnienia

power

Wykorzystanie

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()

chrome.power.releaseKeepAwake(): void

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

reportActivity()

Promise Chrome 113 lub nowszy Tylko ChromeOS 
chrome.power.reportActivity(
  callback?: function,
): 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.

Parametry

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    () => void

Zwroty

  • thought Promise<void>

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

requestKeepAwake()

chrome.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