chrome.power

توضیحات

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

مجوزها

power

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

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

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

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

انواع

Level

Enum

"سیستم"
از خوابیدن سیستم در پاسخ به عدم فعالیت کاربر جلوگیری می کند.

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

روش ها

releaseKeepAwake()

chrome.power.releaseKeepAwake()

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

reportActivity()

فقط ChromeOS 113+ را وعده دهید
chrome.power.reportActivity(
  callback?: function,
)

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

پارامترها

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد: 

    () => void

برمی گرداند

  • قول<باطل>

    Promises در Manifest V3 و نسخه های جدیدتر پشتیبانی می شود، اما callbacks برای سازگاری به عقب ارائه شده است. شما نمی توانید از هر دو در یک فراخوانی تابع استفاده کنید. وعده با همان نوعی که به callback ارسال می شود حل می شود.

requestKeepAwake()

chrome.power.requestKeepAwake(
  level: Level,
)

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

پارامترها