Beschrijving
Gebruik de chrome.wallpaper
API om de ChromeOS-achtergrond te wijzigen.
Machtigingen
wallpaper
U moet de toestemming voor 'wallpaper' in het manifest van de app opgeven om de wallpaper-API te kunnen gebruiken. Bijvoorbeeld:
{
"name": "My extension",
...
"permissions": [
"wallpaper"
],
...
}
Beschikbaarheid
Voorbeelden
Als u bijvoorbeeld de achtergrond wilt instellen als 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() {}
);
Soorten
WallpaperLayout
De ondersteunde achtergrondindelingen.
Enum
"STREK" "CENTRUM" "CENTRUM_CROPPED"
Methoden
setWallpaper()
chrome.wallpaper.setWallpaper(
details: object,
callback?: function,
)
Stelt achtergrond in voor de afbeelding op url of wallpaperData met de opgegeven lay-out
Parameters
- details
voorwerp
- gegevens
ArrayBuffer optioneel
De jpeg- of png-gecodeerde achtergrondafbeelding als ArrayBuffer.
- bestandsnaam
snaar
De bestandsnaam van de opgeslagen achtergrond.
- indeling
De ondersteunde achtergrondindelingen.
- miniatuur
Booleaans optioneel
Waar als er een miniatuur van 128x60 moet worden gegenereerd. Lay-out en verhouding worden nog niet ondersteund.
- URL
tekenreeks optioneel
De URL van de in te stellen achtergrond (kan relatief zijn).
- terugbellen
functie optioneel
De
callback
parameter ziet er als volgt uit:(thumbnail?: ArrayBuffer) => void
- miniatuur
ArrayBuffer optioneel
De jpeg-gecodeerde achtergrondminiatuur. Het wordt gegenereerd door het formaat van de achtergrond te wijzigen naar 128x60.
Retouren
Belofte<ArrayBuffer | ongedefinieerd>
Chroom 96+Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.