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 و نسخه های جدیدتر پشتیبانی می شود، اما callbacks برای سازگاری به عقب ارائه شده است. شما نمی توانید از هر دو در یک فراخوانی تابع استفاده کنید. وعده با همان نوعی که به callback ارسال می شود حل می شود.

queryState()

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

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

مولفه های

  • detectionIntervalInSeconds

    عدد

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

  • پاسخ به تماس

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

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

    (newState: IdleState)=>void

برمی گرداند

  • Promise< IdleState >

    Chrome 116+

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

setDetectionInterval()

chrome.idle.setDetectionInterval(
  intervalInSeconds: number,
)

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

مولفه های

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

    عدد

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

مناسبت ها

onStateChanged

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

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

مولفه های

  • پاسخ به تماس

    تابع

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

    (newState: IdleState)=>void