browser.power

الوصف

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

الأذونات

power

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

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

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

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

الأنواع

Level

Enum

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

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

الطُرق

releaseKeepAwake()

browser.power.releaseKeepAwake(): void

لإلغاء طلب تم إجراؤه سابقًا من خلال requestKeepAwake()‎

reportActivity()

الإصدار 113 من Chrome والإصدارات الأحدث browser.* ‎ منذ الإصدار 148 من Chrome نظام التشغيل Chrome فقط
browser.power.reportActivity(): Promise<void>

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

المرتجعات

  • وعد<فراغ>

requestKeepAwake()

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

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

المعلمات