chrome.wallpaper

Beschreibung

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

Berechtigungen

wallpaper

Sie müssen die Berechtigung „Hintergrund“ im Manifest der App deklarieren, um die Hintergrund API zu verwenden. Beispiel:

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

Verfügbarkeit

Chrome 43 und höher Nur ChromeOS

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 in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.