توضیحات
از chrome.idle
API برای تشخیص تغییر وضعیت بیکار دستگاه استفاده کنید.
مجوزها
idle
برای استفاده از API غیرفعال، باید مجوز "idle"
را در مانیفست برنامه افزودنی خود اعلام کنید. به عنوان مثال:
{
"name": "My extension",
...
"permissions": [
"idle"
],
...
}
انواع
IdleState
Enum
"فعال" "بیکار" "قفل شده"
روش ها
getAutoLockDelay()
chrome.idle.getAutoLockDelay(): Promise<number>
زمان را در چند ثانیه دریافت می کند، تا زمانی که صفحه به طور خودکار در حالت بیکار قفل شود طول می کشد. اگر صفحه هرگز به صورت خودکار قفل نشود، مدت زمان صفر را برمیگرداند. در حال حاضر فقط در سیستم عامل Chrome پشتیبانی می شود.
برمی گرداند
قول <تعداد>
Chrome 116+
queryState()
chrome.idle.queryState(
detectionIntervalInSeconds: number,
): Promise<IdleState>
اگر سیستم قفل باشد، «قفل»، اگر کاربر برای تعداد مشخصی از ثانیه ورودی ایجاد نکرده باشد، «بیکار» یا در غیر این صورت «فعال» برمیگردد.
پارامترها
- detectionIntervalInSeconds
شماره
اگر detectionIntervalInSeconds ثانیه از آخرین ورودی کاربر شناسایی شده گذشته باشد، سیستم بیکار در نظر گرفته می شود.
برمی گرداند
Promise< IdleState >
Chrome 116+
setDetectionInterval()
chrome.idle.setDetectionInterval(
intervalInSeconds: number,
): void
فاصله زمانی مورد استفاده برای تعیین زمانی که سیستم در حالت بیکار برای رویدادهای onStateChanged قرار دارد را بر حسب ثانیه تنظیم می کند. فاصله پیش فرض 60 ثانیه است.
پارامترها
- intervalInSeconds
شماره
آستانه، در ثانیه، برای تعیین زمانی که سیستم در حالت بیکار است استفاده می شود.
رویدادها
onStateChanged
chrome.idle.onStateChanged.addListener(
callback: function,
)
هنگامی که سیستم به حالت فعال، بیکار یا قفل تغییر می کند، فعال می شود. در صورتی که صفحه قفل باشد یا محافظ صفحه فعال شود، رویداد با "قفل" فعال می شود، در صورتی که قفل سیستم باز باشد و کاربر هیچ ورودی برای تعداد مشخصی از ثانیه ایجاد نکرده باشد، "غیرفعال" و زمانی که کاربر ورودی را در یک سیستم غیرفعال تولید کند، "فعال" است.