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
Enum
"idle"
Yöntemler
getAutoLockDelay()
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ümlerVaatler, 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()
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
-
newState
-
İlerlemeler
-
Promise<IdleState>
Chrome 116 ve sonraki sürümlerVaatler, 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.