chrome.idle

الوصف

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

الأذونات

idle

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

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

الأنواع

IdleState

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

التعداد

الطُرق

getAutoLockDelay()

الوعد الإصدار 73 من Chrome أو الإصدارات الأحدث ChromeOS فقط 
chrome.idle.getAutoLockDelay(
  callback?: function,
)

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

المَعلمات

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    (delay: number)=>void

    • delay

      الرقم

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

المرتجعات

  • وعد<الرقم>

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

    تتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.

queryState()

وعد 
chrome.idle.queryState(
  detectionIntervalInSeconds: number,
  callback?: function,
)

عرض "مقفل" إذا كان النظام مقفلاً، أو "غير نشِط لفترة قصيرة" إذا لم ينشئ المستخدم أي إدخال لعدد محدد من الثواني، أو "نشط" بخلاف ذلك.

المَعلمات

  • detectionIntervalInSeconds

    الرقم

    يُعتبر النظام في وضع عدم النشاط إذا انقضت ثواني DiscoveryIntervalInseconds منذ آخر إدخال للمستخدم تم رصده.

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    (newState: IdleState)=>void

المرتجعات

  • Promise<IdleState>

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

    تتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.

setDetectionInterval()

chrome.idle.setDetectionInterval(
  intervalInSeconds: number,
)

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

المَعلمات

  • intervalInSeconds

    الرقم

    الحدّ الأدنى، بالثواني، يُستخدم لتحديد متى يكون النظام في حالة عدم النشاط.

فعاليات

onStateChanged

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

يتم تنشيطها عندما يتغير النظام إلى حالة نشطة أو غير نشطة أو مقفلة. يبدأ الحدث بعبارة "مقفل" إذا كانت الشاشة مقفلة أو تم تفعيل شاشة الاستراحة، وعلى وضع "غير نشِط لفترة قصيرة" إذا كان النظام غير مُقفَل ولم ينشئ المستخدم أي إدخال لعدد محدّد من الثواني، وعلى "نشط" عندما يُدخِل المستخدم إدخالاً على نظام عدم النشاط.

المَعلمات

  • معاودة الاتصال

    الوظيفة

    تبدو معلَمة callback على النحو التالي: 

    (newState: IdleState)=>void