chrome.wallpaper

Beschreibung

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

Berechtigungen

wallpaper

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

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

Verfügbarkeit

Chrome (ab Version 43) Nur ChromeOS

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: 

    (thumbnail?: ArrayBuffer) => void

    • thumbnail

      ArrayBuffer optional

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

Returns

  • Promise&lt;ArrayBuffer | nicht definiert>

    Chrome 96 und höher

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.