browser.power

شرح

از chrome.power API برای لغو ویژگی‌های مدیریت مصرف برق سیستم استفاده کنید.

اجازه‌ها

power

مفاهیم و کاربرد

به‌طور پیش‌فرض، سیستم‌عامل‌ها وقتی کاربران غیرفعال هستند، صفحه را کم‌نور می‌کنند و درنهایت سیستم را تعلیق می‌کنند. با API برق، برنامه یا افزونه می‌تواند سیستم را بیدار نگه دارد.

بااستفاده از این API، می‌توانید سطحی را که مدیریت مصرف برق در آن غیرفعال می‌شود مشخص کنید. سطح "system" سیستم را فعال نگه می‌دارد، اما اجازه می‌دهد صفحه‌نمایش کم‌نور یا خاموش شود. برای مثال، یک برنامه ارتباطی می‌تواند همچنان پیام‌ها را دریافت کند درحالی‌که صفحه‌نمایش خاموش است. سطح "display" صفحه‌نمایش و سیستم را فعال نگه می‌دارد. برای مثال، برنامه‌های کتاب الکترونیک و ارائه می‌توانند صفحه‌نمایش و سیستم را درحین مطالعه کاربران فعال نگه دارند.

وقتی کاربر بیش از یک برنامه یا افزونه فعال دارد که هرکدام سطح توان خود را دارند، سطح با بالاترین اولویت اعمال می‌شود؛ "display" همیشه بر "system" اولویت دارد. برای مثال، اگر برنامه الف درخواست مدیریت مصرف برق "system" را داشته باشد و برنامه ب درخواست "display" را داشته باشد، تا زمانی که برنامه ب بارگیری نشده باشد یا درخواستش را لغو نکرده باشد، از "display" استفاده می‌شود. اگر برنامه الف همچنان فعال باشد، "system" استفاده می‌شود.

انواع

Level

شمارشی

«system»
از به‌خواب رفتن سیستم در پاسخ به غیرفعال بودن کاربر جلوگیری می‌کند.

«نمایش»
از خاموش یا کم‌نور شدن نمایشگر یا رفتن سیستم به حالت خواب درصورت عدم فعالیت کاربر جلوگیری می‌کند.

روش‌ها

releaseKeepAwake()

browser.power.releaseKeepAwake(): void

درخواستی را که قبلاً ازطریق requestKeepAwake()‎ انجام شده است منتشر می‌کند.

reportActivity()

Chrome 113+ browser.* از Chrome 148 فقط ChromeOS
browser.power.reportActivity(): Promise<void>

فعالیت کاربر را گزارش می‌کند تا صفحه‌نمایش را از حالت کم‌نور یا خاموش یا از محافظ صفحه‌نمایش بیدار کند. اگر محافظ صفحه‌نمایش درحال‌حاضر فعال باشد، از آن خارج می‌شود.

بازگشتی‌ها

  • Promise<void>

requestKeepAwake()

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

درخواست می‌کند که مدیریت نیرو موقتاً غیرفعال شود. level میزان غیرفعال شدن مدیریت مصرف برق را توصیف می‌کند. اگر درخواستی که قبلاً توسط همان برنامه انجام شده است هنوز فعال باشد، با درخواست جدید جایگزین خواهد شد.

پارامترها