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