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
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
Los diseños de fondo de pantalla compatibles
Enum
"CENTER_CROPPED"
Métodos
setWallpaper()
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.
-
layout
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
-
Promise<ArrayBuffer | undefined>
Chrome 96 y versiones posterioresLas 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.