chrome.wallpaper

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

Wenn Sie die Wallpaper API verwenden möchten, müssen Sie die Berechtigung „wallpaper“ im Manifest der App deklarieren. Beispiel:

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

Beispiele

Wenn Sie beispielsweise das Hintergrundbild auf das Bild unter 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

Chrome 44 und 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 als JPEG oder PNG codierte Hintergrundbild als ArrayBuffer.

    • filename

      String

      Der Dateiname des gespeicherten Hintergrundbilds.

    • Die unterstützten Hintergrundlayouts.

    • Thumbnail

      boolean optional

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

    • URL

      String optional

      Die URL des festzulegenden Hintergrundbilds (kann relativ sein).

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (thumbnail?: ArrayBuffer) => void

    • Thumbnail

      ArrayBuffer optional

      Das JPEG-codierte Hintergrundbild-Thumbnail. Sie wird durch Anpassen der Größe des Hintergrunds auf 128 × 60 Pixel generiert.

Ausgabe

  • Promise<ArrayBuffer | undefined>

    Chrome 96 und höher

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