تاریخ به‌روزرسانی: 2026-09-25 ربات‌ها: noindex
توضیحات
از API chrome.power برای لغو ویژگی‌های مدیریت انرژی سیستم استفاده کنید.
مجوزها
powerکاربرد
به طور پیش‌فرض، سیستم‌های عامل وقتی کاربران غیرفعال هستند، صفحه نمایش را کم‌نور می‌کنند و در نهایت سیستم را به حالت تعلیق در می‌آورند. با استفاده از Power API، یک برنامه یا افزونه می‌تواند سیستم را بیدار نگه دارد.
با استفاده از این API، می‌توانید سطحی را که مدیریت نیرو در آن غیرفعال است، مشخص کنید. سطح "system" سیستم را فعال نگه می‌دارد، اما به صفحه نمایش اجازه می‌دهد تا کم‌نور یا خاموش شود. به عنوان مثال، یک برنامه ارتباطی می‌تواند در حالی که صفحه نمایش خاموش است، به دریافت پیام ادامه دهد. سطح "display" صفحه نمایش و سیستم را فعال نگه می‌دارد. به عنوان مثال، برنامه‌های کتاب الکترونیکی و ارائه می‌توانند صفحه نمایش و سیستم را در حالی که کاربران مطالعه می‌کنند، فعال نگه دارند.
وقتی کاربری بیش از یک برنامه یا افزونه فعال دارد که هر کدام سطح مصرف انرژی خاص خود را دارند، بالاترین سطح اولویت اعمال می‌شود؛ "display" همیشه بر "system" اولویت دارد. برای مثال، اگر برنامه A درخواست مدیریت مصرف انرژی "system" و برنامه B درخواست "display" ، "display" تا زمانی که برنامه B بارگیری نشود یا درخواست خود را منتشر نکند، استفاده می‌شود. اگر برنامه A هنوز فعال باشد، از "system" استفاده می‌شود.
انواع
Level
شمارشی
«سیستم» "نمایش"
از به خواب رفتن سیستم در پاسخ به عدم فعالیت کاربر جلوگیری می‌کند.
از خاموش یا کم‌نور شدن صفحه نمایش یا به خواب رفتن سیستم در پاسخ به عدم فعالیت کاربر جلوگیری می‌کند.
روش‌ها
releaseKeepAwake()
chrome.power.releaseKeepAwake(): void
درخواستی را که قبلاً از طریق requestKeepAwake() ارسال شده بود، منتشر می‌کند.
reportActivity()
chrome.power.reportActivity(
callback?: function,
): Promise<void>
فعالیت کاربر را برای بیدار کردن صفحه نمایش از حالت کم‌نور یا خاموش یا از حالت محافظ صفحه نمایش گزارش می‌دهد. اگر محافظ صفحه نمایش در حال حاضر فعال باشد، از آن خارج می‌شود.
پارامترها
- تماس برگشتی
تابع اختیاری
پارامتر
callbackبه شکل زیر است:() => void
بازگشت‌ها
قول<void>
Promiseها فقط برای Manifest V3 و نسخه‌های بعدی پشتیبانی می‌شوند، سایر پلتفرم‌ها باید از callbackها استفاده کنند.
requestKeepAwake()
chrome.power.requestKeepAwake(
level: Level,
): void
درخواست‌هایی مبنی بر غیرفعال شدن موقت مدیریت نیرو. level میزان غیرفعال شدن مدیریت نیرو را توصیف می‌کند. اگر درخواستی که قبلاً توسط همان برنامه ارائه شده است هنوز فعال باشد، با درخواست جدید جایگزین خواهد شد.
پارامترها
- سطح