chrome.wallpaper

Descrição

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

Permissões

wallpaper

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

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

Disponibilidade

Chrome 43 ou superior Somente ChromeOS

Exemplos

Por exemplo, para definir o plano de fundo como a imagem em https://example.com/a_file.png, você pode ligar para 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 superior

Os layouts de plano de fundo compatíveis.

Enumeração

"STRETCH"

"CENTRAL"

"CENTER_CROPPED"

Métodos

setWallpaper()

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

Define o plano de fundo para a imagem em 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.

    • Os layouts de plano de fundo compatíveis.

    • miniatura

      booleano opcional

      Verdadeiro se uma miniatura de 128 x 60 precisar ser 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 opcional

    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 redimensionando o plano de fundo para 128 x 60.

Retorna

  • Promise<ArrayBuffer | indefinido>

    Chrome 96 ou versão mais recente

    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.