설명
chrome.idle API를 사용하여 머신의 유휴 상태가 변경되는 시점을 감지합니다.
권한
idle유휴 API를 사용하려면 확장 프로그램의 매니페스트에서 "idle" 권한을 선언해야 합니다. 예를 들면 다음과 같습니다.
{
"name": "My extension",
...
"permissions": [
"idle"
],
...
}
유형
IdleState
열거형
방법
getAutoLockDelay()
chrome.idle.getAutoLockDelay(
callback?: function,
)
유휴 상태에서 화면이 자동으로 잠길 때까지 걸리는 시간(초)을 가져옵니다. 화면이 자동으로 잠기지 않으면 0 지속 시간을 반환합니다. 현재 Chrome OS에서만 지원됩니다.
매개변수
-
콜백
함수 선택사항
callback매개변수는 다음과 같습니다.(delay: number)=>void
-
delay
숫자
유휴 상태에서 화면이 자동으로 잠길 때까지의 시간(초)입니다. 화면이 자동으로 잠기지 않는 경우 0입니다.
-
반환 값
-
프로미스<number>
Chrome 116 이상프로미스는 Manifest V3 이상에서 지원되지만 콜백은 이전 버전과의 호환성을 위해 제공됩니다. 동일한 함수 호출에 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.
queryState()
chrome.idle.queryState(
detectionIntervalInSeconds: number,
callback?: function,
)
시스템이 잠겨 있으면 'locked', 사용자가 지정된 초 동안 입력을 생성하지 않은 경우 'idle', 그렇지 않은 경우 'active'를 반환합니다.
매개변수
-
detectionIntervalInSeconds
숫자
마지막 사용자 입력이 감지된 후 DetectionIntervalInSeconds초가 경과하면 시스템은 유휴 상태로 간주됩니다.
-
콜백
함수 선택사항
callback매개변수는 다음과 같습니다.(newState: IdleState)=>void
-
newState
-
반환 값
-
Promise<IdleState>
Chrome 116 이상프로미스는 Manifest V3 이상에서 지원되지만 콜백은 이전 버전과의 호환성을 위해 제공됩니다. 동일한 함수 호출에 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.
setDetectionInterval()
chrome.idle.setDetectionInterval(
intervalInSeconds: number,
)
시스템이 onStateChanged 이벤트에 대해 유휴 상태인 경우를 결정하는 데 사용되는 간격(초)을 설정합니다. 기본 간격은 60초입니다.
매개변수
-
intervalInSeconds
숫자
시스템이 유휴 상태인지 확인하는 데 사용되는 기준(초)입니다.
이벤트
onStateChanged
chrome.idle.onStateChanged.addListener(
callback: function,
)
시스템이 활성, 유휴 또는 잠금 상태로 변경되면 시작됩니다. 이벤트는 화면이 잠겨 있거나 화면 보호기가 활성화되면 '잠김', 시스템이 잠금 해제되어 있고 사용자가 지정된 시간(초) 동안 입력을 생성하지 않은 경우 '유휴' 상태, 사용자가 유휴 시스템에서 입력을 생성하면 '활성' 상태로 실행됩니다.