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()
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
-
level