Opis
Użyj interfejsu API chrome.idle, aby wykrywać zmiany stanu bezczynności komputera.
Uprawnienia
idleAby korzystać z interfejsu API stanu bezczynności, musisz zadeklarować uprawnienie "idle" w pliku manifestu rozszerzenia. Przykład:
{
"name": "My extension",
...
"permissions": [
"idle"
],
...
}
Typy
IdleState
Typ wyliczeniowy
"active"
"idle"
"locked"
Metody
getAutoLockDelay()
browser.idle.getAutoLockDelay(): Promise<number>
Pobiera czas (w sekundach), po którym ekran jest automatycznie blokowany, gdy urządzenie jest bezczynne. Jeśli ekran nigdy nie jest blokowany automatycznie, zwraca wartość 0. Obecnie obsługiwane tylko w ChromeOS.
Zwroty
-
Promise<number>
Chrome 116 lub nowsza wersja browser.* od Chrome 148
queryState()
browser.idle.queryState(
detectionIntervalInSeconds: number,
): Promise<IdleState>
Zwraca „locked” (zablokowany), jeśli system jest zablokowany, „idle” (bezczynny), jeśli użytkownik nie wygenerował żadnych danych wejściowych przez określoną liczbę sekund, lub „active” (aktywny) w pozostałych przypadkach.
Parametry
-
detectionIntervalInSeconds
liczba
System jest uznawany za nieaktywny, jeśli od ostatniego wykrytego działania użytkownika upłynęło detectionIntervalInSeconds sekund.
Zwroty
-
Promise<IdleState>
Chrome 116 lub nowsza wersja browser.* od Chrome 148
setDetectionInterval()
browser.idle.setDetectionInterval(
intervalInSeconds: number,
): void
Ustawia interwał (w sekundach) używany do określania, kiedy system jest w stanie bezczynności w przypadku zdarzeń onStateChanged. Domyślny interwał to 60 sekund.
Parametry
-
intervalInSeconds
liczba
Próg w sekundach używany do określania, kiedy system jest w stanie bezczynności.
Wydarzenia
onStateChanged
browser.idle.onStateChanged.addListener(
callback: function,
)
Uruchamiane, gdy system przechodzi w stan aktywny, bezczynny lub zablokowany. Zdarzenie jest wywoływane z wartością „locked” (zablokowany), jeśli ekran jest zablokowany lub aktywuje się wygaszacz ekranu, „idle” (bezczynny), jeśli system jest odblokowany, a użytkownik nie wygenerował żadnych danych wejściowych przez określoną liczbę sekund, oraz „active” (aktywny), gdy użytkownik generuje dane wejściowe w bezczynnym systemie.