chrome.wallpaper

Beschreibung

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

Berechtigungen

wallpaper

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"
  ],
  ...
}

Verfügbarkeit

Chrome 43 und höher Nur ChromeOS

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()

chrome.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 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).

Ausgabe

  • Promise<ArrayBuffer | undefined>

    Chrome 96 und höher