chrome.power

الوصف

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

الأذونات

power

الاستخدام

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

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

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

الأنواع

Level

Enum

"النظام"
يمنع النظام من الانتقال إلى وضع السكون عند عدم نشاط المستخدم.

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

الطُرق

releaseKeepAwake()

chrome.power.releaseKeepAwake(): void

تؤدي هذه الطريقة إلى إلغاء طلب تم إجراؤه سابقًا باستخدام requestKeepAwake().

reportActivity()

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

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

المعلمات

  • callback

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

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

    () => void

المرتجعات

  • Promise<void>

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

requestKeepAwake()

chrome.power.requestKeepAwake(
  level: Level,
): void

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

المعلمات