chrome.wallpaper

Descrizione

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

Autorizzazioni

wallpaper

Disponibilità

Chrome 43+ Solo ChromeOS

Manifest

Per utilizzare l'API wallpaper, devi dichiarare l'autorizzazione "wallpaper" nel manifest dell'app. Ad esempio:

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

Esempi

Ad esempio, per impostare lo sfondo come l'immagine all'indirizzo 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+

I layout dello sfondo supportati.

Enum

"STRETCH"

"CENTER"

"CENTER_CROPPED"

Metodi

setWallpaper()

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

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

Parametri

  • dettagli

    oggetto

    • dati

      ArrayBuffer facoltativo

      L'immagine dello sfondo codificata in formato JPEG o PNG come ArrayBuffer.

    • nome file

      stringa

      Il nome del file dello sfondo salvato.

    • I layout dello sfondo supportati.

    • miniatura

      booleano facoltativo

      True se deve essere generata una miniatura 128x60. Il layout e le proporzioni non sono ancora supportati.

    • url

      stringa facoltativa

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

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (thumbnail?: ArrayBuffer) => void

    • miniatura

      ArrayBuffer facoltativo

      La miniatura dello sfondo codificata in JPEG. Viene generata ridimensionando lo sfondo a 128 x 60.

Resi

  • Promise<ArrayBuffer | undefined>

    Chrome 96+

    Le promesse sono supportate solo per Manifest V3 e versioni successive, le altre piattaforme devono utilizzare i callback.