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