chrome.idle

설명

chrome.idle API를 사용하여 머신의 유휴 상태가 변경되는 시점을 감지합니다.

권한

idle

매니페스트

유휴 API를 사용하려면 확장 프로그램의 매니페스트에서 'idle' 권한을 선언해야 합니다. 예를 들면 다음과 같습니다.

{
  "name": "My extension",
  ...
  "permissions": [
    "idle"
  ],
  ...
}

유형

IdleState

Chrome 44 이상

열거형

'active'

'idle'

"locked"

메서드

getAutoLockDelay()

Promise Chrome 73 이상 ChromeOS만 해당 
chrome.idle.getAutoLockDelay(
  callback?: function,
): Promise<number>

유휴 상태일 때 화면이 자동으로 잠길 때까지 걸리는 시간(초)을 가져옵니다. 화면이 자동으로 잠기지 않는 경우 0 기간을 반환합니다. 현재 ChromeOS에서만 지원됩니다.

매개변수

  • callback

    함수 선택사항

    callback 매개변수는 다음과 같습니다. 

    (delay: number) => void

    • delay

      숫자

      유휴 상태일 때 화면이 자동으로 잠길 때까지의 시간(초)입니다. 화면이 자동으로 잠기지 않는 경우 0입니다.

반환 값

  • Promise<number>

    Chrome 116 이상

    Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

queryState()

Promise 
chrome.idle.queryState(
  detectionIntervalInSeconds: number,
  callback?: function,
): Promise<IdleState>

시스템이 잠겨 있으면 'locked'를 반환하고, 사용자가 지정된 시간 동안 입력을 생성하지 않으면 'idle'을 반환하며, 그렇지 않으면 'active'를 반환합니다.

매개변수

  • detectionIntervalInSeconds

    숫자

    마지막으로 감지된 사용자 입력 이후 detectionIntervalInSeconds 초가 경과하면 시스템이 유휴 상태로 간주됩니다.

  • callback

    함수 선택사항

    callback 매개변수는 다음과 같습니다. 

    (newState: IdleState) => void

반환 값

  • Promise<IdleState>

    Chrome 116 이상

    Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

setDetectionInterval()

chrome.idle.setDetectionInterval(
  intervalInSeconds: number,
): void

onStateChanged 이벤트에서 시스템이 유휴 상태인지 확인하는 데 사용되는 간격(초)을 설정합니다. 기본 간격은 60초입니다.

매개변수

  • intervalInSeconds

    숫자

    시스템이 유휴 상태인지 판단하는 데 사용되는 기준점(초)입니다.

이벤트

onStateChanged

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

시스템이 활성, 유휴 또는 잠금 상태로 변경될 때 발생합니다. 화면이 잠겨 있거나 화면 보호기가 활성화되면 'locked'로 이벤트가 발생하고, 시스템이 잠금 해제되어 있고 사용자가 지정된 시간 동안 입력을 생성하지 않으면 'idle'로, 사용자가 유휴 상태인 시스템에서 입력을 생성하면 'active'로 이벤트가 발생합니다.

매개변수

  • callback

    함수

    callback 매개변수는 다음과 같습니다. 

    (newState: IdleState) => void