chroom.behang

Beschrijving

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

Machtigingen

wallpaper

Beschikbaarheid

Chrome 43+ Alleen ChromeOS

Manifest

Je moet de toestemming 'achtergrond' in het manifest van de app opgeven om de achtergrond-API te 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 op deze manier aanroepen:

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

Typen

WallpaperLayout

Chroom 44+

De ondersteunde achtergrondindelingen.

Enum

"STREKKEN"

"CENTRUM"

"CENTRUM_BIJGESNEDEN"

Methoden

setWallpaper()

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

Stelt de achtergrond in op de afbeelding op url of 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 het opgeslagen behang.

    • De ondersteunde achtergrondindelingen.

    • miniatuur

      boolean optioneel

      True als er een miniatuur van 128x60 moet worden gegenereerd. Lay-out en verhouding worden nog niet ondersteund.

    • url

      string optioneel

      De URL van het in te stellen behang (kan relatief zijn).

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    (thumbnail?: ArrayBuffer) => void

    • miniatuur

      ArrayBuffer optioneel

      De jpeg-gecodeerde thumbnail van de achtergrond. Deze wordt gegenereerd door de achtergrond te verkleinen naar 128x60.

Retourneren

  • Belofte<ArrayBuffer | undefined>

    Chroom 96+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.