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 "wallpaper" no manifesto do app para usar a API Wallpaper. Exemplo:

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

Disponibilidade

Chrome 43 ou mais recente Somente no ChromeOS

Exemplos

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

Enumeração

"STRETCH"

"CENTER"

"CENTER_CROPPED"

Métodos

setWallpaper()

Promise 
chrome.wallpaper.setWallpaper(
  details: object,
  callback?: function,
): Promise<ArrayBuffer | undefined>

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

Parâmetros

  • detalhes

    objeto

    • dados

      ArrayBuffer opcional

      A imagem do 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

      "True" se uma miniatura de 128 x 60 precisar ser gerada. O layout e a proporção ainda não são compatíveis.

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

Retorna

  • Promise<ArrayBuffer | undefined>

    Chrome 96+