chrome.power

설명

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

권한

power

개념 및 사용법

기본적으로 운영체제는 사용자가 비활성 상태일 때 화면을 어둡게 하고 결국에는 시스템을 정지합니다. 전원 API를 사용하면 앱이나 익스텐션이 시스템을 켜진 상태로 유지할 수 있습니다.

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

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

유형

Level

열거형

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

"display"
사용자 비활성으로 인해 디스플레이가 꺼지거나 어두워지는 것을 방지하거나 시스템이 절전 모드로 전환되지 않도록 합니다.

방법

releaseKeepAwake()

chrome.power.releaseKeepAwake()

requestKeepAwake()를 통해 이전에 수행했던 요청을 해제합니다.

reportActivity()

Promise Chrome 113 이상 ChromeOS만 해당 
chrome.power.reportActivity(
  callback?: function,
)

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

매개변수

  • 콜백

    함수 선택사항

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

    ()=>void

반환 값

  • Promise<void>

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

requestKeepAwake()

chrome.power.requestKeepAwake(
  level: Level,
)

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

매개변수