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 escurecem a tela quando os usuários ficam inativos e suspendem o sistema. Com a API de energia, um app ou extensão pode manter o sistema ativo.

Com essa API, você pode especificar o Level em que o gerenciamento de energia será desativado. O "system" mantém o sistema ativo, mas permite que a tela seja esmaecida ou desligada. Por exemplo, de comunicação do Google pode continuar recebendo mensagens enquanto a tela estiver desligada. No nível do "display" mantém a tela e o sistema ativos. Apps de e-books e apresentações, 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 ativa, cada um com o próprio nível de poder, o nível de maior precedência entra em vigor; "display" sempre tem precedência sobre "system". Para Por exemplo, se o app A pedir o gerenciamento de energia "system" e o app B pedir "display", "display" é usado até que o app B seja descarregado ou libere sua solicitação. Se o app A ainda estiver ativo, "system" será são usadas.

Tipos

Level

Enumeração

"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 modo de suspensão em resposta à inatividade do usuário.

Métodos

releaseKeepAwake()

chrome.power.releaseKeepAwake()

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

reportActivity()

Promessa Chrome 113 ou versões mais recentes Somente ChromeOS 
chrome.power.reportActivity(
  callback?: function,
)

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

Parâmetros

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promessa<void>

    O Manifesto V3 e versões mais recentes oferecem suporte a promessas, mas callbacks são fornecidos para a compatibilidade com versões anteriores. Não é possível usar ambos na mesma chamada de função. A promessa é resolvida com o mesmo tipo passado ao retorno de chamada.

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 deve ser desativado. Se uma solicitação feita anteriormente pelo mesmo app ainda estiver ativa, ela será substituída pela nova.

Parâmetros