תיאור
אפשר להשתמש ב-API chrome.idle כדי לזהות מתי משתנה מצב חוסר הפעילות של המכונה.
הרשאות
idleמניפסט
עליך להצהיר על 'לא פעיל' במניפסט של התוסף להשתמש ב-API ללא פעילות. לדוגמה:
{
"name": "My extension",
...
"permissions": [
"idle"
],
...
}
סוגים
IdleState
Enum
"פעיל"
"לא פעיל"
'נעול'
שיטות
getAutoLockDelay()
chrome.idle.getAutoLockDelay(
callback?: function,
)
מקבל את השעה, בשניות, עד שהמסך ננעל אוטומטית בזמן חוסר פעילות. הפונקציה מחזירה משך זמן של אפס אם המסך אף פעם לא ננעל באופן אוטומטי. נכון לעכשיו, האפשרות נתמכת רק ב-ChromeOS.
פרמטרים
-
קריאה חוזרת (callback)
פונקציה אופציונלית
הפרמטר
callbackנראה כך:(delay: number) => void
-
עיכוב
number
הזמן, בשניות, עד שהמסך ננעל אוטומטית בזמן חוסר פעילות. הערך הוא אפס אם המסך אף פעם לא ננעל באופן אוטומטי.
-
החזרות
-
Promise<number>
Chrome 116 ואילךהבטחות נתמכות רק במניפסט מגרסה V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callback).
queryState()
chrome.idle.queryState(
detectionIntervalInSeconds: number,
callback?: function,
)
הפונקציה מחזירה 'נעול'. אם המערכת נעולה, 'לא פעילה' אם המשתמש לא יצר קלט במשך מספר מסוים של שניות, או 'פעיל' אחרת.
פרמטרים
-
detectionIntervalInSeconds
number
המערכת נחשבת לא פעילה אם חלפו שניות מאז הזיהוי האחרון של הקלט מהמשתמש.
-
קריאה חוזרת (callback)
פונקציה אופציונלית
הפרמטר
callbackנראה כך:(newState: IdleState) => void
-
newState
-
החזרות
-
Promise<IdleState>
Chrome 116 ואילךהבטחות נתמכות רק במניפסט מגרסה V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callback).
setDetectionInterval()
chrome.idle.setDetectionInterval(
intervalInSeconds: number,
)
המדיניות הזו מגדירה את מרווח הזמן (בשניות) שמשמש כדי לקבוע מתי המערכת במצב לא פעיל לאירועי onStateChanged. מרווח הזמן שמוגדר כברירת מחדל הוא 60 שניות.
פרמטרים
-
intervalInSeconds
number
הסף בשניות משמש כדי לקבוע מתי המערכת במצב לא פעיל.
אירועים
onStateChanged
chrome.idle.onStateChanged.addListener(
callback: function,
)
מופעל כשהמערכת משתנה למצב פעיל, לא פעיל או נעול. האירוע מופעל כשהוא 'נעול' אם המסך נעול או ששומר המסך מופעל, הכיתוב 'לא פעיל' אם המערכת לא נעולה והמשתמש לא יצר קלט במשך מספר מסוים של שניות, במצב 'פעיל' כשהמשתמש יוצר קלט במערכת לא פעילה.