chrome.wallpaper

Description

Utilisez l'API chrome.wallpaper pour modifier le fond d'écran ChromeOS.

Autorisations

wallpaper

Garantie de disponibilité

Chrome 43 et versions ultérieures ChromeOS uniquement

Manifest

Vous devez déclarer l'autorisation "fond d'écran" dans le fichier manifeste de l'application pour utiliser l'API fond d'écran. Exemple :

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

Exemples

Par exemple, pour définir le fond d'écran comme image sur https://example.com/a_file.png, vous pouvez appeler chrome.wallpaper.setWallpaper comme suit:

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

Types

WallpaperLayout

Chrome 44 ou version ultérieure

Dispositions de fond d'écran compatibles.

Enum

"CENTER_CROPPED"

Méthodes

setWallpaper()

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

Définit le fond d'écran sur l'image url ou wallpaperData avec la mise en page spécifiée

Paramètres

  • détails

    objet

    • data

      ArrayBuffer facultatif

      Image de fond d'écran encodée au format JPEG ou PNG en tant que ArrayBuffer.

    • filename

      chaîne

      Nom de fichier du fond d'écran enregistré.

    • mise en page

      WallpaperLayout

      Dispositions de fond d'écran compatibles.

    • thumbnail

      Booléen facultatif

      "True" si une vignette de 128 x 60 doit être générée. La mise en page et le format ne sont pas encore acceptés.

    • url

      string facultatif

      URL du fond d'écran à définir (elle peut être relative).

  • rappel

    fonction facultative

    Le paramètre callback se présente comme suit : 

    (thumbnail?: ArrayBuffer)=>void

    • thumbnail

      ArrayBuffer facultatif

      Miniature du fond d'écran encodé au format JPEG. Il est généré en redimensionnant le fond d'écran à 128 x 60.

Renvoie

  • Promise<ArrayBuffer|undefined>

    Chrome 96 et versions ultérieures

    Les promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.