chrome.power

refresh date: 2026-09-25 robots: noindex

Opis

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

Uprawnienia

power

Wykorzystanie

Domyślnie systemy operacyjne przyciemniają ekran, gdy użytkownicy są nieaktywni, a następnie wstrzymują działanie systemu. Za pomocą interfejsu 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 uprawnień, obowiązuje poziom o najwyższym priorytecie. "display" zawsze ma wyższy priorytet niż "system". Jeśli na przykład aplikacja A poprosi o "system" zarządzanie zasilaniem, a aplikacja B poprosi o "display", "display" będzie używane, dopóki aplikacja B nie zostanie zwolniona lub nie wycofa prośby. Jeśli aplikacja A jest nadal aktywna, używana jest wartość "system".

Typy

Level

Typ wyliczeniowy

„system”
Zapobiega przejściu systemu w stan uśpienia w odpowiedzi na nieaktywność 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()

Promise Chrome 113 lub nowszy Tylko ChromeOS 
chrome.power.reportActivity(
  callback?: function,
): Promise<void>

Raportuje aktywność użytkownika, aby wybudzić ekran z przyciemnionego lub wyłączonego stanu albo z wygaszacza ekranu. Wyłącza wygaszacz ekranu, jeśli jest on obecnie aktywny.

Parametry

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    () => void

Zwroty

  • Promise<void>

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

requestKeepAwake()

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

Żądanie 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