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'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 ve sonraki sürümler 'nı inceleyin.

Enum

"active"

"boşta"

"kilitli"

Yöntemler

getAutoLockDelay()

Söz Chrome 73 ve sonraki sürümler Yalnızca ChromeOS
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üre döndürür. Şu anda yalnızca Chrome OS'de desteklenir.

Parametreler

  • geri çağırma

    işlev isteğe bağlı

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

    (delay: number) => void

    • gecikme

      sayı

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

İadeler

  • Promise<number>

    Chrome 116 ve sonraki sürümler 'nı inceleyin.

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

queryState()

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

"locked" değerini döndürür sistem kilitliyse "boşta" kullanıcı belirli sayıda saniye boyunca herhangi bir giriş oluşturmadıysa veya "etkin" aksi takdirde.

Parametreler

  • detectionIntervalInSeconds

    sayı

    Son kullanıcı girişinin algılanmasının üzerinden saniye geçmişse deDetectIntervalInSeconds saniye geçmişse sistem boşta olarak kabul edilir.

  • geri çağırma

    işlev isteğe bağlı

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

    (newState: IdleState) => void

İadeler

  • Promise<IdleState>

    Chrome 116 ve sonraki sürümler 'nı inceleyin.

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

setDetectionInterval()

chrome.idle.setDetectionInterval(
  intervalInSeconds: number,
)

Sistemin onStateChanged etkinlikleri için boşta durumda olduğunu belirlemek amacıyla kullanılan aralığı saniye cinsinden ayarlar. Varsayılan aralık 60 saniyedir.

Parametreler

  • intervalInSeconds

    sayı

    Saniye cinsinden eşik, sistemin boşta olduğunu belirlemek için kullanılır.

Etkinlikler

onStateChanged

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

Sistem etkin, boşta veya kilitli durumuna geçtiğinde tetiklenir. Etkinlik "kilitli" ayarıyla tetikleniyor ekran kilitliyse veya ekran koruyucu etkinleşiyorsa "boşta" sistemin kilidi açıksa ve kullanıcı belirli sayıda saniye boyunca herhangi bir giriş oluşturmadıysa ve "etkin"se Kullanıcı boşta bir sistemde giriş oluşturduğunda.

Parametreler

  • geri çağırma

    işlev

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

    (newState: IdleState) => void