chrome.power

Descrição

Use a API chrome.power para substituir os recursos de gerenciamento de energia do sistema.

Permissões

power

Conceitos e uso

Por padrão, os sistemas operacionais esmaecem a tela quando os usuários estão inativos e suspendem o sistema. Com a API de energia, um app ou extensão pode manter o sistema ativado.

Com essa API, é possível especificar o nível em que o gerenciamento de energia está desativado. O nível "system" mantém o sistema ativo, mas permite que a tela seja esmaecida ou desativada. Por exemplo, um app de comunicação pode continuar a receber mensagens enquanto a tela está apagada, mas o nível "display" mantém a tela e o sistema ativos. Apps de e-book e apresentação, por exemplo, podem manter a tela e o sistema ativos enquanto os usuários leem.

Quando um usuário tem mais de um app ou extensão ativo, cada um com o próprio nível de poder, o nível de precedência mais alta entra em vigor. "display" sempre tem precedência sobre "system". Por exemplo, se o app A solicitar o gerenciamento de energia "system" e o app B solicitar "display", "display" será usado até que o app B seja descarregado ou libere a solicitação. Se o app A ainda estiver ativo, o "system" será usado.

Tipos

Level

Tipo enumerado

"system"
Impede que o sistema entre em modo de suspensão em resposta à inatividade do usuário.

"display"
Impede que a tela seja desligada ou esmaecida ou que o sistema entre em suspensão em resposta à inatividade do usuário.

Métodos

releaseKeepAwake()

chrome.power.releaseKeepAwake()

Libera uma solicitação feita anteriormente por requestKeepAwake().

reportActivity()

Promise Chrome 113+ Somente ChromeOS 
chrome.power.reportActivity(
  callback?: function,
)

Informa uma atividade de usuário para ativar a tela de um estado esmaecido ou desativado ou de um protetor de tela. Sai do protetor de tela se ele estiver ativo.

Parâmetros

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    ()=>void

Retorna

  • Promise<void>

    Promessas são compatíveis com o Manifest V3 e versões mais recentes, mas callbacks são fornecidos para compatibilidade com versões anteriores. Não é possível usar os dois na mesma chamada de função. A promessa é resolvida com o mesmo tipo que é passado para o callback.

requestKeepAwake()

chrome.power.requestKeepAwake(
  level: Level,
)

Solicita que o gerenciamento de energia seja temporariamente desativado. level descreve o grau em que o gerenciamento de energia precisa ser desativado. Se uma solicitação feita anteriormente pelo mesmo app ainda estiver ativa, ela será substituída pela nova.

Parâmetros