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