chrome.wallpaper

Descripción

Usa la API de chrome.wallpaper para cambiar el fondo de pantalla de ChromeOS.

Permisos

wallpaper

Disponibilidad

Chrome 43 y versiones posteriores Solo en ChromeOS

Manifiesto

Debes declarar el permiso "wallpaper" en el manifiesto de la app para usar la API de Wallpaper. Por ejemplo:

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

Ejemplos

Por ejemplo, para establecer el fondo de pantalla como la imagen en https://example.com/a_file.png, puedes llamar a chrome.wallpaper.setWallpaper de esta manera:

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

Tipos

WallpaperLayout

Chrome 44 y versiones posteriores

Son los diseños de fondo de pantalla admitidos.

Enum

"STRETCH"

"CENTER"

"CENTER_CROPPED"

Métodos

setWallpaper()

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

Establece el fondo de pantalla en la imagen de url o wallpaperData con el diseño especificado.

Parámetros

  • detalles

    objeto

    • datos

      ArrayBuffer opcional

      Imagen de fondo de pantalla codificada en formato JPEG o PNG como ArrayBuffer.

    • filename

      string

      Nombre de archivo del fondo de pantalla guardado.

    • diseño

      WallpaperLayout

      Son los diseños de fondo de pantalla admitidos.

    • miniatura

      booleano opcional

      Es verdadero si se debe generar una miniatura de 128 x 60. Aún no se admiten el diseño ni la proporción.

    • url

      cadena opcional

      Es la URL del fondo de pantalla que se establecerá (puede ser relativa).

  • callback

    función opcional

    El parámetro callback se ve de la siguiente manera: 

    (thumbnail?: ArrayBuffer) => void

    • miniatura

      ArrayBuffer opcional

      Es la miniatura del fondo de pantalla codificada en JPEG. Se genera cambiando el tamaño del fondo de pantalla a 128 x 60.

Muestra

  • Promesa<ArrayBuffer | undefined>

    Chrome 96 y versiones posteriores

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.