chrome.wallpaper

refresh date: 2026-09-25 robots: noindex

Beschreibung

Verwenden Sie die chrome.wallpaper API, um den ChromeOS-Hintergrund zu ändern.

Berechtigungen

wallpaper

Verfügbarkeit

Chrome 43 und höher Nur ChromeOS

Manifest

Du musst die Berechtigung „wallpaper“ im Manifest der App deklarieren, um die Wallpaper API zu verwenden. Beispiel:

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

Beispiele

Wenn Sie beispielsweise das Bild unter https://example.com/a_file.png als Hintergrund 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

Chrome 44 oder höher

Die unterstützten Hintergrundlayouts.

Enum

"STRETCH"

"CENTER"

"CENTER_CROPPED"

Methoden

setWallpaper()

Promise 
chrome.wallpaper.setWallpaper(
  details: object,
  callback?: function,
): Promise<ArrayBuffer | undefined>

Legt das Hintergrundbild auf 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.

    • Die unterstützten Hintergrundlayouts.

    • Thumbnail

      Boolesch optional

      „True“, wenn ein Thumbnail mit 128 × 60 Pixeln generiert werden soll. Layout und Seitenverhältnis werden noch nicht unterstützt.

    • URL

      String optional

      Die URL des festzulegenden Hintergrunds (kann relativ sein).

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (thumbnail?: ArrayBuffer) => void

    • Thumbnail

      ArrayBuffer optional

      Die JPEG-codierte Miniaturansicht des Hintergrunds. Es wird generiert, indem die Größe des Hintergrunds auf 128 × 60 angepasst wird.

Ausgabe

  • Promise<ArrayBuffer | undefined>

    Chrome 96 oder höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.