الوصف
استخدِم واجهة برمجة التطبيقات chrome.idle لرصد أي تغيير في حالة عدم النشاط على الجهاز.
الأذونات
idleيجب الإفصاح عن إذن "idle" في بيان الإضافة لاستخدام واجهة برمجة التطبيقات الخاصة بحالة عدم النشاط. على سبيل المثال:
{
"name": "My extension",
...
"permissions": [
"idle"
],
...
}
الأنواع
IdleState
Enum
"active"
"idle"
"locked"
الطُرق
getAutoLockDelay()
browser.idle.getAutoLockDelay(): Promise<number>
تسترجع هذه السياسة الوقت بالثواني الذي يستغرقه قفل الشاشة تلقائيًا أثناء عدم النشاط. يتم عرض مدة صفرية إذا لم يتم قفل الشاشة تلقائيًا مطلقًا. تتوفّر هذه الميزة حاليًا على نظام التشغيل Chrome فقط.
المرتجعات
-
<number>
الإصدار 116 من Chrome والإصدارات الأحدث browser.* منذ الإصدار 148 من Chrome
queryState()
browser.idle.queryState(
detectionIntervalInSeconds: number,
): Promise<IdleState>
تعرض هذه السياسة "مُقفل" إذا كان النظام مقفلاً، أو "غير نشط" إذا لم يُنشئ المستخدم أي إدخال لعدد محدّد من الثواني، أو "نشط" في الحالات الأخرى.
المعلمات
-
detectionIntervalInSeconds
الرقم
يُعتبر النظام غير نشط إذا انقضت ثوانٍ من detectionIntervalInSeconds منذ آخر إدخال تم رصده من المستخدم.
المرتجعات
-
Promise<IdleState>
الإصدار 116 من Chrome والإصدارات الأحدث browser.* منذ الإصدار 148 من Chrome
setDetectionInterval()
browser.idle.setDetectionInterval(
intervalInSeconds: number,
): void
يضبط هذا الإعداد الفاصل الزمني بالثواني المستخدَم لتحديد وقت دخول النظام في حالة عدم النشاط لأحداث onStateChanged. الفاصل الزمني التلقائي هو 60 ثانية.
المعلمات
-
intervalInSeconds
الرقم
الحدّ الأدنى، بالثواني، المستخدَم لتحديد متى يكون النظام في حالة عدم نشاط.
الفعاليات
onStateChanged
browser.idle.onStateChanged.addListener(
callback: function,
)
يتم تشغيل هذا الحدث عندما يتغيّر النظام إلى حالة نشطة أو غير نشطة أو مقفلة. يتم تنشيط الحدث باستخدام "مُقفَل" إذا كانت الشاشة مقفلة أو تم تفعيل شاشة الاستراحة، و"غير نشط" إذا كان النظام غير مقفل ولم يُنشئ المستخدم أي إدخال لعدد محدّد من الثواني، و "نشط" عندما يُنشئ المستخدم إدخالاً على نظام غير نشط.