browser.wallpaper

Beschreibung

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

Berechtigungen

wallpaper

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

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

Verfügbarkeit

Chrome 43 und höher browser.* seit Chrome 148 Nur ChromeOS

Beispiele

Wenn Sie beispielsweise das Bild unter https://example.com/a_file.png als Hintergrund festlegen möchten, können Sie browser.wallpaper.setWallpaper so aufrufen:

browser.wallpaper.setWallpaper(
  {
    'url': 'https://example.com/a_file.jpg',
    'layout': 'CENTER_CROPPED',
    'filename': 'test_wallpaper'
  },
  function() {}
);

Typen

WallpaperLayout

Chrome 44 und höher browser.* seit Chrome 148

Die unterstützten Hintergrundlayouts.

Enum

"STRETCH"

"CENTER"

"CENTER_CROPPED"

Methoden

setWallpaper()

browser.wallpaper.setWallpaper(
  details: object,
): 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).

Ausgabe

  • Promise<ArrayBuffer | undefined>

    Chrome 96+ browser.* seit Chrome 148