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

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

Chrome 44 und höher

Die unterstützten Hintergrundlayouts.

Enum

"CENTER_CROPPED"

Methoden

setWallpaper()

Versprechen 
chrome.wallpaper.setWallpaper(
  details: object,
  callback?: function,
)

Legt als Hintergrund das Bild unter url oder wallpaperData mit dem angegebenen layout fest

Parameters

  • 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

      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ückgaben

  • Promise<ArrayBuffer|undefined>

    Chrome 96 oder höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.