설명
chrome.idle API를 사용하여 머신의 유휴 상태가 변경되는 시점을 감지합니다.
권한
idle유휴 API를 사용하려면 확장 프로그램의 매니페스트에서 "idle" 권한을 선언해야 합니다. 예를 들면 다음과 같습니다.
{ "name": "My extension", ... "permissions": [ "idle" ], ... } 유형
IdleState
Chrome 44 이상
열거형
'active'
'idle'
"locked"
메서드
getAutoLockDelay()
Chrome 73 이상 ChromeOS만 해당
chrome.idle.getAutoLockDelay(): Promise<number>
유휴 상태일 때 화면이 자동으로 잠길 때까지 걸리는 시간(초)을 가져옵니다. 화면이 자동으로 잠기지 않는 경우 0 기간을 반환합니다. 현재 ChromeOS에서만 지원됩니다.
반환 값
-
Promise<number>
Chrome 116 이상
queryState()
chrome.idle.queryState(
detectionIntervalInSeconds: number,
): Promise<IdleState>
시스템이 잠겨 있으면 'locked'를 반환하고, 사용자가 지정된 시간 동안 입력을 생성하지 않으면 'idle'을 반환하며, 그렇지 않으면 'active'를 반환합니다.
매개변수
- detectionIntervalInSeconds
숫자
마지막으로 감지된 사용자 입력 이후 detectionIntervalInSeconds 초가 경과하면 시스템이 유휴 상태로 간주됩니다.
반환 값
-
Promise<IdleState>
Chrome 116 이상
setDetectionInterval()
chrome.idle.setDetectionInterval(
intervalInSeconds: number,
): void
onStateChanged 이벤트에서 시스템이 유휴 상태인지 확인하는 데 사용되는 간격(초)을 설정합니다. 기본 간격은 60초입니다.
매개변수
- intervalInSeconds
숫자
시스템이 유휴 상태인지 판단하는 데 사용되는 기준점(초)입니다.
이벤트
onStateChanged
chrome.idle.onStateChanged.addListener(
callback: function,
)
시스템이 활성, 유휴 또는 잠금 상태로 변경될 때 발생합니다. 화면이 잠겨 있거나 화면 보호기가 활성화되면 'locked'로 이벤트가 발생하고, 시스템이 잠금 해제되어 있고 사용자가 지정된 시간 동안 입력을 생성하지 않으면 'idle'로, 사용자가 유휴 상태인 시스템에서 입력을 생성하면 'active'로 이벤트가 발생합니다.