chroom.behang

Vernieuwingsdatum: 2026-09-25 robots: noindex

Beschrijving

Gebruik de chrome.wallpaper API om de achtergrond van ChromeOS te wijzigen.

Toestemmingen

wallpaper

Beschikbaarheid

Chrome 43+ Alleen voor ChromeOS

Manifest

Je moet de "wallpaper"-toestemming in het manifest van de app declareren om de wallpaper-API te kunnen gebruiken. Bijvoorbeeld:

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

Voorbeelden

Om bijvoorbeeld de achtergrond in te stellen als de afbeelding op https://example.com/a_file.png , kunt u chrome.wallpaper.setWallpaper als volgt aanroepen:

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

Soorten

WallpaperLayout

Chrome 44+

De ondersteunde achtergrondindelingen.

Enum

"STREKKEN"

"CENTRUM"

"CENTER_CROPPED"

Methoden

setWallpaper()

Belofte
chrome.wallpaper.setWallpaper(
  details: object,
  callback?: function,
): Promise<ArrayBuffer | undefined>

Stelt de achtergrond in op de afbeelding op de opgegeven URL of in de gegevensmap 'wallpaperData' met de opgegeven lay-out.

Parameters

  • details

    voorwerp

    • gegevens

      ArrayBuffer optioneel

      De jpeg- of png-gecodeerde achtergrondafbeelding als een ArrayBuffer.

    • bestandsnaam

      snaar

      De bestandsnaam van de opgeslagen achtergrondafbeelding.

    • De ondersteunde achtergrondindelingen.

    • miniatuur

      boolean optioneel

      Retourneert 'waar' als er een miniatuurafbeelding van 128x60 pixels moet worden gegenereerd. Indeling en beeldverhouding worden nog niet ondersteund.

    • URL

      string optioneel

      De URL van de in te stellen achtergrondafbeelding (mag relatief zijn).

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (thumbnail?: ArrayBuffer) => void

    • miniatuur

      ArrayBuffer optioneel

      De JPEG-gecodeerde miniatuur van de achtergrondafbeelding. Deze wordt gegenereerd door de achtergrondafbeelding te verkleinen tot 128x60 pixels.

Retourneert

  • Promise<ArrayBuffer | undefined>

    Chrome 96+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.