chrome.power

الوصف

استخدِم واجهة برمجة التطبيقات chrome.power API لإلغاء ميزات إدارة الطاقة في النظام.

الأذونات

power

المفاهيم والاستخدام

تعتيم الشاشة تلقائيًا عندما يكون المستخدمون غير نشطين، وتؤدي أنظمة التشغيل في نهاية المطاف إلى تعليق النظام. باستخدام واجهة برمجة التطبيقات Power API، يمكن لتطبيق أو إضافة إبقاء النظام نشطًا.

باستخدام واجهة برمجة التطبيقات هذه، يمكنك تحديد المستوى الذي يتم إيقاف إدارة الطاقة عليه. يحافظ المستوى "system" على تفعيل النظام، ولكن يسمح بتعتيم الشاشة أو إيقافها. على سبيل المثال، يمكن لتطبيق التواصل تلقّي الرسائل عندما تكون الشاشة مطفأة. ويحافظ المستوى "display" على نشاط الشاشة والنظام. على سبيل المثال، يمكن لتطبيقات الكتب الإلكترونية والعروض التقديمية إبقاء الشاشة والنظام نشطين أثناء القراءة.

عندما يكون لدى المستخدم أكثر من تطبيق أو إضافة نشطة، يكون لكل تطبيق مستوى طاقته الخاص، ويتم تطبيق مستوى الأولوية الأعلى، و تكون الأولوية دائمًا لـ "display" على "system". على سبيل المثال، إذا طلب التطبيق "أ" إدارة الطاقة "system"، وطلب التطبيق "ب" تفعيل "display"، يتم استخدام "display" إلى أن يتم إلغاء تحميل التطبيق "ب" أو إصدار طلبه. إذا كان التطبيق "أ" لا يزال نشطًا، سيتم استخدام "system".

الأنواع

Level

التعداد

"system"
يمنع النظام من وضع السكون استجابة لتوقّف نشاط المستخدم.

"display"
تمنع هذه الميزة إيقاف الشاشة أو تعتيمها، أو منع النظام من السكون استجابةً لتوقُّف نشاط المستخدم.

الطُرق

releaseKeepAwake()

chrome.power.releaseKeepAwake()

لإصدار طلب تم تقديمه سابقًا عبر requestKeepAwake().

reportActivity()

ميزات التوفير الإصدار 113 من Chrome أو الإصدارات الأحدث لأجهزة ChromeOS فقط 
chrome.power.reportActivity(
  callback?: function,
)

تُبلغ عن نشاط المستخدم لتنشيط الشاشة من حالة تعتيمها أو إيقافها أو من شاشة الاستراحة. للخروج من شاشة الاستراحة إذا كانت نشطة حاليًا.

المَعلمات

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

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

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

    ()=>void

المرتجعات

  • Promise<void>

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

requestKeepAwake()

chrome.power.requestKeepAwake(
  level: Level,
)

طلبات إيقاف إدارة الطاقة مؤقتًا. توضِّح level الدرجة التي يجب إيقاف إدارة الطاقة بها. إذا كان الطلب الذي قدّمه التطبيق نفسه في السابق لا يزال نشطًا، سيتم استبداله بالطلب الجديد.

المَعلمات