chrome.idle

الوصف

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

الأذونات

idle

البيان

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

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

الأنواع

IdleState

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

Enum

"active"

"idle"

"locked"

الطُرق

getAutoLockDelay()

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

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

المعلمات

  • callback

    الدالة اختيارية

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

    (delay: number) => void

    • تأخير

      الرقم

      الوقت بالثواني حتى يتم قفل الشاشة تلقائيًا أثناء الخمول تكون هذه القيمة صفرًا إذا لم يتم قفل الشاشة تلقائيًا مطلقًا.

المرتجعات

  • Promise<number>

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

    لا تتوافق الوعود إلا مع الإصدار Manifest V3 والإصدارات الأحدث، ويجب أن تستخدم المنصات الأخرى عمليات رد الاتصال.

queryState()

الوعد 
chrome.idle.queryState(
  detectionIntervalInSeconds: number,
  callback?: function,
): Promise<IdleState>

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

المعلمات

  • detectionIntervalInSeconds

    الرقم

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

  • callback

    الدالة اختيارية

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

    (newState: IdleState) => void

المرتجعات

  • Promise<IdleState>

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

    لا تتوافق الوعود إلا مع الإصدار Manifest V3 والإصدارات الأحدث، ويجب أن تستخدم المنصات الأخرى عمليات رد الاتصال.

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