chrome.wallpaper

Descrição

Use a API chrome.wallpaper para mudar o plano de fundo do ChromeOS.

Permissões

wallpaper

É necessário declarar a permissão "plano de fundo" no manifesto do app para usar a API de plano de fundo. Exemplo:

{
  "name": "My extension",
  ...
  "permissions": [
    "wallpaper"
  ],
  ...
}

Disponibilidade

Chrome 43+ Apenas no ChromeOS

Exemplos

Por exemplo, para definir o plano de fundo como a imagem em https://example.com/a_file.png, você pode chamar chrome.wallpaper.setWallpaper desta forma:

chrome.wallpaper.setWallpaper(
  {
    'url': 'https://example.com/a_file.jpg',
    'layout': 'CENTER_CROPPED',
    'filename': 'test_wallpaper'
  },
  function() {}
);

Tipos

WallpaperLayout

Chrome 44 ou mais recente

Os layouts de plano de fundo compatíveis.

Tipo enumerado

"CENTER_CROPPED"

Métodos

setWallpaper()

Promessa 
chrome.wallpaper.setWallpaper(
  details: object,
  callback?: function,
)

Define o plano de fundo como a imagem no url ou wallpaperData com o layout especificado

Parâmetros

  • detalhes

    objeto

    • dados

      ArrayBuffer opcional

      A imagem de plano de fundo codificada em jpeg ou png como um ArrayBuffer.

    • filename

      string

      O nome do arquivo do plano de fundo salvo.

    • layout.

      WallpaperLayout

      Os layouts de plano de fundo compatíveis.

    • miniatura

      booleano opcional

      Verdadeiro se uma miniatura de 128 x 60 for gerada. Ainda não há suporte para layout e proporção.

    • url

      string opcional

      O URL do plano de fundo a ser definido (pode ser relativo).

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    (thumbnail?: ArrayBuffer)=>void

    • miniatura

      ArrayBuffer opcional

      A miniatura do plano de fundo codificada em jpeg. Ele é gerado ao redimensionar o plano de fundo para 128 x 60.

Retorna

  • Promessa<ArrayBuffer|indefinida>

    Chrome 96 ou mais recente

    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.