الوصف
استخدِم واجهة برمجة التطبيقات chrome.power
لإلغاء ميزات إدارة الطاقة في النظام.
الأذونات
power
المفاهيم والاستخدام
بشكلٍ تلقائي، تعمل أنظمة التشغيل على تعتيم الشاشة عندما لا يكون المستخدمون نشطين، ثم يتم تعليق النظام في النهاية. باستخدام Power API، يمكن لتطبيق أو إضافة إبقاء النظام نشطًا.
باستخدام واجهة برمجة التطبيقات هذه، يمكنك تحديد المستوى الذي يتم فيه إيقاف إدارة الطاقة. يحافظ المستوى "system"
على نشاط النظام، ولكنّه يسمح بتعتيم الشاشة أو إيقافها. على سبيل المثال، يمكن لتطبيق
للتواصل مواصلة تلقّي الرسائل أثناء إيقاف الشاشة. يحافظ المستوى "display"
على نشاط الشاشة والنظام. على سبيل المثال، يمكن لتطبيقات الكتب الإلكترونية والعروض التقديمية إبقاء الشاشة والنظام نشطَين أثناء قراءة المستخدمين.
عندما يكون لدى المستخدم أكثر من تطبيق أو إضافة نشطة، ولكل منها مستوى طاقة خاص به، يسري مستوى الأولوية الأعلى، إذ تكون "display"
دائمًا أعلى أولوية من "system"
. على سبيل المثال، إذا طلب التطبيق "أ" إذن "system"
لإدارة الطاقة، وطلب التطبيق "ب" إذن "display"
، سيتم استخدام "display"
إلى أن يتم إلغاء تحميل التطبيق "ب" أو إلغاء طلبه. إذا كان التطبيق (أ) لا يزال نشطًا، سيتم استخدام "system"
.
الأنواع
Level
Enum
"النظام"
يمنع النظام من الانتقال إلى وضع السكون عند عدم نشاط المستخدم.
"display"
يمنع إيقاف الشاشة أو تعتيمها أو وضع النظام في وضع السكون استجابةً لعدم نشاط المستخدم.
الطُرق
releaseKeepAwake()
chrome.power.releaseKeepAwake(): void
تؤدي هذه الطريقة إلى إلغاء طلب تم إجراؤه سابقًا باستخدام requestKeepAwake().
reportActivity()
chrome.power.reportActivity(): Promise<void>
تسجّل هذه السمة نشاط المستخدم من أجل تنشيط الشاشة من حالة التعتيم أو الإيقاف أو من شاشة التوقف. يخرج من شاشة التوقف إذا كانت نشطة حاليًا.
المرتجعات
-
Promise<void>
requestKeepAwake()
chrome.power.requestKeepAwake(
level: Level,
): void
طلبات إيقاف ميزة "إدارة الطاقة" مؤقتًا توضّح السمة level
مدى ضرورة إيقاف إدارة الطاقة. إذا كان الطلب الذي قدّمه التطبيق نفسه سابقًا لا يزال نشطًا، سيتم استبداله بالطلب الجديد.
المعلمات
-
المستوى