chrome.wallpaper

Descripción

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

Permisos

wallpaper

Para usar la API de fondo de pantalla, debes declarar el permiso de "fondo de pantalla" en el manifiesto de la app. Por ejemplo:

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

Disponibilidad

Chrome 43 y versiones posteriores Solo para ChromeOS

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

Los diseños de fondo de pantalla compatibles

Enum

"CENTER_CROPPED"

Métodos

setWallpaper()

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

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

Parámetros

  • detalles

    objeto

    • datos

      ArrayBuffer opcional

      La imagen de fondo de pantalla codificada en jpeg o png como un ArrayBuffer.

    • filename

      cadena

      El nombre de archivo del fondo de pantalla guardado.

    • diseño

      WallpaperLayout

      Los diseños de fondo de pantalla compatibles

    • miniatura

      booleano opcional

      Es verdadero si se debe generar una miniatura de 128 x 60. El diseño y la proporción aún no son compatibles.

    • url

      cadena opcional

      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

      Miniatura del fondo de pantalla con codificación jpeg. Se genera cambiando el tamaño del fondo de pantalla a 128 x 60.

Devuelve

  • Promesa<ArrayBuffer|undefined>

    Chrome 96 y versiones posteriores

    Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa se resuelve con el mismo tipo que se pasa a la devolución de llamada.