chrome.idle

Açıklama

Makinenin boşta kalma durumunun ne zaman değiştiğini algılamak için chrome.idle API'yi kullanın.

İzinler

idle

Boşta API'yı 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 ve sonraki sürümler

Enum

"idle"

Yöntemler

getAutoLockDelay()

Promise Yalnızca Chrome 73 ve üstü sürümler ChromeOS yalnızca 
chrome.idle.getAutoLockDelay(
  callback?: function,
)

Boştayken ekran otomatik olarak kilitlenene kadar geçen süreyi saniye cinsinden alır. Ekran hiçbir zaman otomatik olarak kilitlenmezse sıfır süreyi döndürür. Şu anda yalnızca Chrome OS'te desteklenmektedir.

Parametreler

  • geri çağırma

    Functions (isteğe bağlı)

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

    (delay: number)=>void

    • delay

      sayı

      Boştayken ekran otomatik olarak kilitlenene kadar geçen süre (saniye cinsinden). Ekran hiçbir zaman otomatik olarak kilitlenmezse bu değer sıfırdır.

İlerlemeler

  • Vaat<sayı>

    Chrome 116 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

queryState()

Söz 
chrome.idle.queryState(
  detectionIntervalInSeconds: number,
  callback?: function,
)

Sistem kilitliyse "kilitli", kullanıcı belirtilen sayıda saniye boyunca herhangi bir giriş oluşturmadıysa "boş", aksi takdirde "etkin" değerini döndürür.

Parametreler

  • detectionIntervalInSeconds

    sayı

    Son kullanıcı girişinin algılandığı son algılamadan bu yana saniyeler geçerse sistemin boşta olduğu kabul edilir.

  • geri çağırma

    Functions (isteğe bağlı)

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

    (newState: IdleState)=>void

İlerlemeler

  • Promise<IdleState>

    Chrome 116 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

setDetectionInterval()

chrome.idle.setDetectionInterval(
  intervalInSeconds: number,
)

Sistemin onStateChanged etkinlikleri için boşta durumda olup olmadığını belirlemek üzere kullanılan aralığı saniye cinsinden ayarlar. Varsayılan aralık 60 saniyedir.

Parametreler

  • intervalInSeconds

    sayı

    Sistemin boşta durumunu belirlemek için kullanılan, saniye cinsinden eşik.

Etkinlikler

onStateChanged

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

Sistem etkin, boşta veya kilitli durumuna geçtiğinde tetiklenir. Etkinlik, ekran kilitlenirse veya ekran koruyucu etkinleştirilirse "kilitli", sistemin kilidi açıksa ve kullanıcı, belirli sayıda saniye boyunca herhangi bir giriş oluşturmamışsa "boşta" ve kullanıcı boştaki bir sistemde giriş oluşturduğunda "etkin" ifadesiyle tetiklenir.

Parametreler

  • geri çağırma

    işlev

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

    (newState: IdleState)=>void