chrome.power

설명

chrome.power API를 사용하여 시스템의 전원 관리 기능을 재정의합니다.

권한

power

개념 및 사용

기본적으로 운영체제는 사용자가 비활성 상태일 때 화면을 어둡게 하고 결국 시스템을 일시 중단합니다. 전원 API를 사용하면 앱이나 확장 프로그램이 시스템을 절전 모드로 전환하지 않을 수 있습니다.

이 API를 사용하면 전원 관리가 사용 중지되는 수준을 지정할 수 있습니다. "system" 수준은 시스템을 활성 상태로 유지하지만 화면을 어둡게 하거나 끌 수 있습니다. 예를 들어 통신 앱은 화면이 꺼져 있는 동안에도 메시지를 계속 수신할 수 있습니다. "display" 수준은 화면과 시스템을 활성 상태로 유지합니다. 예를 들어 e북 및 프레젠테이션 앱은 사용자가 읽는 동안 화면과 시스템을 활성 상태로 유지할 수 있습니다.

사용자가 활성화된 앱이나 확장 프로그램을 두 개 이상 보유하고 각 앱이나 확장 프로그램의 전원 수준이 다른 경우 우선순위가 가장 높은 수준이 적용됩니다. "display"는 항상 "system"보다 우선합니다. 예를 들어 앱 A가 "system" 전원 관리를 요청하고 앱 B가 "display"를 요청하는 경우 앱 B가 언로드되거나 요청을 해제할 때까지 "display"가 사용됩니다. 앱 A가 여전히 활성 상태이면 "system"가 사용됩니다.

유형

Level

열거형

'system'
사용자 비활성 상태에 응답하여 시스템이 절전 모드로 전환되지 않도록 합니다.

'display'
사용자 비활성 상태에 따라 디스플레이가 꺼지거나 어두워지거나 시스템이 절전 모드로 전환되는 것을 방지합니다.

메서드

releaseKeepAwake()

chrome.power.releaseKeepAwake(): void

requestKeepAwake()를 통해 이전에 이루어진 요청을 해제합니다.

reportActivity()

Chrome 113 이상 ChromeOS만 해당
chrome.power.reportActivity(): Promise<void>

화면이 어두워졌거나 꺼진 상태 또는 화면 보호기에서 화면을 깨우기 위해 사용자 활동을 보고합니다. 현재 활성 상태인 경우 화면 보호기를 종료합니다.

반환 값

  • Promise<void>

requestKeepAwake()

chrome.power.requestKeepAwake(
  level: Level,
)
: void

전원 관리를 일시적으로 사용 중지하도록 요청합니다. level는 전원 관리를 사용 중지해야 하는 정도를 설명합니다. 이전에 동일한 앱에서 요청한 요청이 아직 활성 상태인 경우 새 요청으로 대체됩니다.

매개변수