chrome.idle

Açıklama

Makinenin boşta kalma durumu değiştiğinde bunu algılamak için chrome.idle API'yi kullanın.

İzinler

idle

Manifest

idle API'yi kullanmak için uzantınızın manifest dosyasında"idle" iznini beyan etmeniz gerekir. Örneğin:

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

Türler

IdleState

Chrome 44 veya daha yeni bir sürüm

Enum

"active"

"idle"

"locked"

Yöntemler

getAutoLockDelay()

Promise Chrome 73 ve sonraki sürümler Yalnızca ChromeOS 
chrome.idle.getAutoLockDelay(
  callback?: function,
): Promise<number>

Boşta kalma durumunda ekranın otomatik olarak kilitlenmesi için gereken süreyi saniye cinsinden alır. Ekran hiçbir zaman otomatik olarak kilitlenmezse sıfır süre döndürür. Şu anda yalnızca ChromeOS'te desteklenmektedir.

Parametreler

  • callback

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (delay: number) => void

    • gecikme

      sayı

      Boşta kalma durumunda ekranın otomatik olarak kilitlenmesine kadar geçecek süre (saniye). Ekran hiçbir zaman otomatik olarak kilitlenmiyorsa bu değer sıfırdır.

İadeler

  • Promise<number>

    Chrome 116 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

queryState()

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

Sistem kilitliyse "locked", kullanıcı belirli bir süre boyunca herhangi bir giriş yapmadıysa "idle", aksi takdirde "active" değerini döndürür.

Parametreler

  • detectionIntervalInSeconds

    sayı

    Algılanan son kullanıcı girişinden bu yana detectionIntervalInSeconds saniye geçtiyse sistem boşta kabul edilir.

  • callback

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (newState: IdleState) => void

İadeler

  • Promise<IdleState>

    Chrome 116 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

setDetectionInterval()

chrome.idle.setDetectionInterval(
  intervalInSeconds: number,
): void

Sistemin onStateChanged etkinlikleri için ne zaman boşta olduğunu belirlemek üzere kullanılan aralığı saniye cinsinden ayarlar. Varsayılan aralık 60 saniyedir.

Parametreler

  • intervalInSeconds

    sayı

    Sistemin ne zaman boşta kalma durumunda olduğunu belirlemek için kullanılan eşik (saniye cinsinden).

Etkinlikler

onStateChanged

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

Sistem etkin, boşta veya kilitli duruma geçtiğinde tetiklenir. Ekran kilitlenirse veya ekran koruyucu etkinleştirilirse etkinlik "locked" (kilitli) ile, sistemin kilidi açılırsa ve kullanıcı belirli bir süre boyunca herhangi bir giriş yapmazsa "idle" (boşta), kullanıcı boşta kalan bir sistemde giriş yaparsa "active" (etkin) ile tetiklenir.

Parametreler

  • callback

    işlev

    callback parametresi şu şekilde görünür: 

    (newState: IdleState) => void