chrome.wallpaper

Beschreibung

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

Berechtigungen

wallpaper

Verfügbarkeit

Chrome (ab Version 43) Nur ChromeOS

Manifest

Sie müssen den „Hintergrund“ deklarieren im Manifest der App die Berechtigung zur Verwendung die Hintergrund-API. Beispiel:

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

Beispiele

Um den Hintergrund beispielsweise als Bild auf https://example.com/a_file.png, Sie können chrome.wallpaper.setWallpaper anrufen auf folgende Weise:

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

Typen

WallpaperLayout

Chrome (ab Version 44)

Die unterstützten Hintergrundlayouts.

Enum

"STRETCH"

"MITTEL"

"CENTER_CROPPED"

Methoden

setWallpaper()

<ph type="x-smartling-placeholder"></ph> Versprechen 
chrome.wallpaper.setWallpaper(
  details: object,
  callback?: function,
)

Legt den Hintergrund 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

      Boolescher Wert optional

      Dieser Wert ist "True", wenn eine Miniaturansicht im Format 128 x 60 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: <ph type="x-smartling-placeholder"></ph>

    (thumbnail?: ArrayBuffer) => void

    • thumbnail

      ArrayBuffer optional

      Die JPEG-codierte Hintergrundbild-Miniaturansicht. Es wird generiert, indem der Hintergrund auf 128 x 60 zugeschnitten wird.

Gibt Folgendes zurück:

  • Promise&lt;ArrayBuffer | nicht definiert>

    Chrome 96 und höher

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