chrome.idle

توضیحات

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

مجوزها

idle

آشکار

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

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

انواع

IdleState

Chrome 44+

Enum

"فعال"

"بیکار"

"قفل شده"

روش ها

getAutoLockDelay()

فقط ChromeOS 73+ را وعده دهید
chrome.idle.getAutoLockDelay(
  callback?: function,
)

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

پارامترها

  • پاسخ به تماس

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

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

    (delay: number) => void

    • تاخیر

      شماره

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

برمی گرداند

  • قول <تعداد>

    Chrome 116+

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

queryState()

قول بده
chrome.idle.queryState(
  detectionIntervalInSeconds: number,
  callback?: function,
)

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

پارامترها

  • detectionIntervalInSeconds

    شماره

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

  • پاسخ به تماس

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

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

    (newState: IdleState) => void

برمی گرداند

  • Promise< IdleState >

    Chrome 116+

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

setDetectionInterval()

chrome.idle.setDetectionInterval(
  intervalInSeconds: number,
)

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

پارامترها

  • فاصله در ثانیه

    شماره

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

رویدادها

onStateChanged

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

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

پارامترها

  • پاسخ به تماس

    تابع

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

    (newState: IdleState) => void