chrome.idle

توضیحات

از chrome.idle API برای تشخیص تغییر وضعیت بیکار دستگاه استفاده کنید.

مجوزها

idle

برای استفاده از API غیرفعال، باید مجوز "idle" را در مانیفست برنامه افزودنی خود اعلام کنید. به عنوان مثال:

{
  "name": "My extension",
  ...
  "permissions": [
    "idle"
  ],
  ...
}

انواع

IdleState

Chrome 44+

Enum

"فعال"

"بیکار"

"قفل شده"

روش ها

getAutoLockDelay()

فقط Chrome 73+ ChromeOS
chrome.idle.getAutoLockDelay(): Promise<number>

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

برمی گرداند

  • قول <تعداد>

    Chrome 116+

queryState()

chrome.idle.queryState(
  detectionIntervalInSeconds: number,
)
: Promise<IdleState>

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

پارامترها

  • detectionIntervalInSeconds

    شماره

    اگر detectionIntervalInSeconds ثانیه از آخرین ورودی کاربر شناسایی شده گذشته باشد، سیستم بیکار در نظر گرفته می شود.

برمی گرداند

setDetectionInterval()

chrome.idle.setDetectionInterval(
  intervalInSeconds: number,
)
: void

فاصله زمانی مورد استفاده برای تعیین زمانی که سیستم در حالت بیکار برای رویدادهای onStateChanged قرار دارد را بر حسب ثانیه تنظیم می کند. فاصله پیش فرض 60 ثانیه است.

پارامترها

  • intervalInSeconds

    شماره

    آستانه، در ثانیه، برای تعیین زمانی که سیستم در حالت بیکار است استفاده می شود.

رویدادها

onStateChanged

chrome.idle.onStateChanged.addListener(
  callback: function,
)

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

پارامترها

  • پاسخ به تماس

    تابع

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

    (newState: IdleState) => void