chrome.idle

Opis

Użyj interfejsu chrome.idle API, aby wykrywać zmiany stanu bezczynności urządzenia.

Uprawnienia

idle

Aby korzystać z interfejsu API idle, musisz zadeklarować uprawnienie "idle" w pliku manifestu rozszerzenia. Przykład:

{   "name": "My extension",   ...   "permissions": [     "idle"   ],   ... }

Typy

IdleState

Chrome 44 lub nowszy

Typ wyliczeniowy

„aktywny”

„idle”

„locked”

Metody

getAutoLockDelay()

Chrome 73 lub nowszy Tylko ChromeOS 
chrome.idle.getAutoLockDelay(): Promise<number>

Pobiera czas (w sekundach), po jakim ekran jest automatycznie blokowany w stanie bezczynności. Jeśli ekran nigdy nie jest blokowany automatycznie, zwraca czas trwania równy zero. Obecnie obsługiwane tylko w ChromeOS.

Zwroty

  • Promise<number>

    Chrome 116 lub nowsza

queryState()

chrome.idle.queryState(
  detectionIntervalInSeconds: number,
): Promise<IdleState>

Zwraca wartość „locked”, jeśli system jest zablokowany, „idle”, jeśli użytkownik nie wprowadził żadnych danych przez określony czas, lub „active” w innych przypadkach.

Parametry

  • detectionIntervalInSeconds

    liczba

    System jest uznawany za nieaktywny, jeśli od ostatniej wykrytej interakcji użytkownika upłynęło detectionIntervalInSeconds sekund.

Zwroty

setDetectionInterval()

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

chrome.idle.onStateChanged.addListener(
  callback: function,
)

Wyzwalane, gdy system przechodzi w stan aktywny, bezczynny lub zablokowany. Zdarzenie jest wywoływane z wartością „locked”, jeśli ekran jest zablokowany lub wygaszacz jest aktywny, „idle”, jeśli system jest odblokowany, a użytkownik nie wykonał żadnej czynności przez określony czas, oraz „active”, gdy użytkownik wykona czynność w nieaktywnym systemie.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    (newState: IdleState) => void