chrome.power

refresh date: 2026-09-25 robots: noindex

الوصف

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

الأذونات

power

الاستخدام

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

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

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

الأنواع

Level

Enum

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

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

الطُرق

releaseKeepAwake()

chrome.power.releaseKeepAwake(): void

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

reportActivity()

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

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

المعلمات

  • callback

    function اختياري

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

    () => void

المرتجعات

  • وعد<فراغ>

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

requestKeepAwake()

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

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

المعلمات