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