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 para ChromeOS

Manifest

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"
  ],
  ...
}

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 solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.