chrome.power

설명

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

권한

power

개념 및 사용법

기본적으로 운영체제에서는 사용자가 비활성 상태일 때 화면을 어둡게 하고 결국에는 사용자가 있습니다. Power API를 사용하면 앱 또는 확장 프로그램이 시스템을 켜진 상태로 유지할 수 있습니다.

이 API를 사용하여 전원 관리가 사용 중지되는 Level을 지정할 수 있습니다. "system" 수준은 시스템은 활성 상태로 유지되지만 화면을 어둡게 하거나 끌 수 있습니다. 예를 들어 화면이 꺼져 있어도 커뮤니케이션 앱이 계속해서 메시지를 수신할 수 있습니다. "display" 수준 화면과 시스템을 활성 상태로 유지합니다 예를 들어 eBook 및 프레젠테이션 앱에서 화면을 그대로 유지함 활성 상태임을 알 수 있습니다.

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

유형

Level

열거형

"system"
사용자 비활성에 대한 응답으로 시스템이 절전 모드로 전환되지 않도록 합니다.

"display"
디스플레이가 꺼지거나 어두워지거나 사용자의 활동이 없어 시스템이 절전 모드로 전환되는 것을 방지합니다.

메서드

releaseKeepAwake()

chrome.power.releaseKeepAwake()

이전에 requestKeepAwake()를 통해 보낸 요청을 해제합니다.

reportActivity()

<ph type="x-smartling-placeholder"></ph> 프로미스 Chrome 113 이상 ChromeOS만 해당 
chrome.power.reportActivity(
  callback?: function,
)

화면을 어둡게 하거나 꺼진 상태나 화면 보호기에서 깨우기 위해 사용자 활동을 보고합니다. 현재 활성화된 경우 화면 보호기를 종료합니다.

매개변수

  • 콜백

    함수 선택사항

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

    () => void

반환 값

  • 프로미스<void>

    프로미스는 Manifest V3 이상에서 지원되지만 이전 버전과의 호환성입니다. 같은 함수 호출에서 두 가지를 모두 사용할 수는 없습니다. 이 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

requestKeepAwake()

chrome.power.requestKeepAwake(
  level: Level,
)

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

매개변수