Beschreibung
Verwenden Sie die chrome.wallpaper
API, um den ChromeOS-Hintergrund zu ändern.
Berechtigungen
wallpaper
Verfügbarkeit
Manifest
Sie müssen die Berechtigung „Hintergrund“ im Manifest der App deklarieren, um die Hintergrund API zu verwenden. Beispiel:
{
"name": "My extension",
...
"permissions": [
"wallpaper"
],
...
}
Beispiele
Wenn Sie beispielsweise den Hintergrund als Bild bei https://example.com/a_file.png
festlegen möchten, können Sie chrome.wallpaper.setWallpaper
so aufrufen:
chrome.wallpaper.setWallpaper(
{
'url': 'https://example.com/a_file.jpg',
'layout': 'CENTER_CROPPED',
'filename': 'test_wallpaper'
},
function() {}
);
Typen
WallpaperLayout
Die unterstützten Hintergrundlayouts.
Enum
"CENTER_CROPPED"
Methoden
setWallpaper()
chrome.wallpaper.setWallpaper(
details: object,
callback?: function,
)
Legt als Hintergrund das Bild unter url oder wallpaperData mit dem angegebenen layout fest
Parameter
-
Details
Objekt
-
daten
ArrayBuffer optional
Das JPEG- oder PNG-codierte Hintergrundbild als ArrayBuffer.
-
filename
String
Der Dateiname des gespeicherten Hintergrunds.
-
Layout
Die unterstützten Hintergrundlayouts.
-
thumbnail
Boolescher Wert optional
Dieser Wert ist „True“, wenn eine Miniaturansicht der Größe 128 × 60 Pixel generiert werden soll. Layout und Seitenverhältnis werden noch nicht unterstützt.
-
url
String optional
Die URL des festzulegenden Hintergrunds (kann relativ sein).
-
-
callback
Funktion optional
Der Parameter
callback
sieht so aus:(thumbnail?: ArrayBuffer) => void
-
thumbnail
ArrayBuffer optional
Die JPEG-codierte Hintergrund-Miniaturansicht. Es wird generiert, indem die Größe des Hintergrunds auf 128 x 60 Pixel geändert wird.
-
Rückgabe
-
Promise<ArrayBuffer | undefined>
Chrome 96 und höherPromise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.