chrome.power

الوصف

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

الأذونات

power

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

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

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

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

الأنواع

Level

Enum

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

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

الطُرق

releaseKeepAwake()

chrome.power.releaseKeepAwake()

إصدار طلب تم إجراؤه سابقًا من خلال requestKeepAwake().

reportActivity()

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

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

المعلمات

  • رد الاتصال

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

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

    () => void

المرتجعات

  • وعود <باطلة>

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

requestKeepAwake()

chrome.power.requestKeepAwake(
  level: Level,
)

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

المعلمات