chrome.idle

الوصف

استخدِم واجهة برمجة التطبيقات chrome.idle لرصد التغييرات في حالة عدم النشاط على الجهاز.

الأذونات

idle

يجب الإفصاح عن الإذن "idle" في بيان الإضافة لاستخدام واجهة برمجة التطبيقات غير النشطة. على سبيل المثال:

{   "name": "My extension",   ...   "permissions": [     "idle"   ],   ... }

الأنواع

IdleState

Chrome 44 والإصدارات الأحدث

Enum

"active"

"idle"

"locked"

الطُرق

getAutoLockDelay()

الإصدار 73 من Chrome والإصدارات الأحدث نظام التشغيل ChromeOS فقط 
chrome.idle.getAutoLockDelay(): Promise<number>

تعرض هذه السمة الوقت بالثواني الذي يستغرقه قفل الشاشة تلقائيًا أثناء الخمول. تعرض هذه السمة مدة صفر إذا لم يتم قفل الشاشة تلقائيًا مطلقًا. لا تتوفّر هذه الميزة حاليًا إلا على أجهزة ChromeOS.

المرتجعات

  • Promise<number>

    الإصدار 116 من Chrome والإصدارات الأحدث

queryState()

chrome.idle.queryState(
  detectionIntervalInSeconds: number,
): Promise<IdleState>

تعرض هذه السمة القيمة "locked" إذا كان النظام مقفلاً، أو "idle" إذا لم يُدخل المستخدم أي بيانات لعدد محدّد من الثواني، أو "active" في الحالات الأخرى.

المعلمات

  • detectionIntervalInSeconds

    الرقم

    يُعدّ النظام غير نشط إذا مرّت detectionIntervalInSeconds ثانية منذ آخر إدخال رصده المستخدم.

المرتجعات

  • Promise<IdleState>

    الإصدار 116 من Chrome والإصدارات الأحدث

setDetectionInterval()

chrome.idle.setDetectionInterval(
  intervalInSeconds: number,
): void

تضبط هذه السمة الفاصل الزمني بالثواني المستخدَم لتحديد وقت توقّف النظام عن العمل في أحداث onStateChanged. الفاصل الزمني التلقائي هو 60 ثانية.

المعلمات

  • intervalInSeconds

    الرقم

    الحدّ الأدنى، بالثواني، المستخدَم لتحديد وقت انتقال النظام إلى حالة الخمول

الفعاليات

onStateChanged

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

يتم تنشيط هذا الحدث عندما يتغير النظام إلى حالة نشطة أو خاملة أو مقفلة. يتم تشغيل الحدث مع القيمة "locked" إذا كانت الشاشة مقفلة أو تم تفعيل شاشة التوقف، والقيمة "idle" إذا كان النظام غير مقفل ولم يُدخل المستخدم أي بيانات لعدد محدّد من الثواني، والقيمة "active" عندما يُدخل المستخدم بيانات على نظام غير نشط.

المعلمات

  • callback

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (newState: IdleState) => void