chrome.wallpaper

Descrizione

Utilizza l'API chrome.wallpaper per cambiare lo sfondo di ChromeOS.

Autorizzazioni

wallpaper

Per poter usare l'API per gli sfondi, devi dichiarare l'autorizzazione "Sfondo" nel manifest dell'app. Ad esempio:

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

Disponibilità

Chrome 43 e versioni successive Solo ChromeOS

Esempi

Ad esempio, per impostare lo sfondo come immagine in https://example.com/a_file.png, puoi chiamare chrome.wallpaper.setWallpaper in questo modo:

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

Tipi

WallpaperLayout

Chrome 44 e versioni successive

I layout di sfondo supportati.

Enum

"CENTER_CROPPED"

Metodi

setWallpaper()

Promessa 
chrome.wallpaper.setWallpaper(
  details: object,
  callback?: function,
)

Imposta lo sfondo sull'immagine all'indirizzo url o wallpaperData con il layout specificato

Parametri

  • dettagli

    oggetto

    • dati

      ArrayBuffer facoltativo

      L'immagine di sfondo codificata in jpeg o png come ArrayBuffer.

    • filename

      stringa

      Il nome file dello sfondo salvato.

    • I layout di sfondo supportati.

    • thumbnail

      booleano facoltativo

      True se deve essere generata una miniatura 128 x 60. Layout e proporzioni non sono ancora supportati.

    • url

      stringa facoltativo

      L'URL dello sfondo da impostare (può essere relativo).

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (thumbnail?: ArrayBuffer)=>void

    • thumbnail

      ArrayBuffer facoltativo

      La miniatura dello sfondo con codifica jpeg. Viene generato ridimensionando lo sfondo a 128 x 60.

Ritorni

  • Promessa<Arraybu|undefined>

    Chrome 96 e versioni successive

    Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.