chrome.power

refresh date: 2026-09-25 robots: noindex

الوصف

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

الأذونات

power

الاستخدام

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

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

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

الأنواع

Level

تعداد

"النظام"
يمنع النظام من الانتقال إلى وضع السكون عند عدم نشاط المستخدم.

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

الطُرق

releaseKeepAwake()

chrome.power.releaseKeepAwake(): void

تؤدي إلى إلغاء طلب تم إجراؤه سابقًا باستخدام requestKeepAwake().

reportActivity()

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

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

المعلمات

  • callback

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

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

    () => void

المرتجعات

  • Promise<void>

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

requestKeepAwake()

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

طلبات إيقاف ميزة "إدارة الطاقة" مؤقتًا توضّح السمة level درجة إيقاف إدارة الطاقة. إذا كان طلب سبق أن قدّمه التطبيق نفسه لا يزال نشطًا، سيتم استبداله بالطلب الجديد.

المعلمات