Beschreibung
Verwenden Sie die chrome.wallpaper
API, um den ChromeOS-Hintergrund zu ändern.
Berechtigungen
wallpaper
Sie müssen die Berechtigung „Hintergrund“ im Manifest der App deklarieren, um die Hintergrund API zu verwenden. Beispiel:
{
"name": "My extension",
...
"permissions": [
"wallpaper"
],
...
}
Verfügbarkeit
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 in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.