chrome.wallpaper

Description

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

Autorisations

wallpaper

Disponibilité

Chrome 43 et versions ultérieures ChromeOS uniquement

Fichier manifeste

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

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

Exemples

Par exemple, pour définir le fond d'écran sur l'image à l'adresse https://example.com/a_file.png, vous pouvez appeler chrome.wallpaper.setWallpaper de cette manière :

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

Types

WallpaperLayout

Chrome 44 et versions ultérieures

Mises en page de fond d'écran compatibles.

Énumération

"STRETCH"

"CENTER"

"CENTER_CROPPED"

Méthodes

setWallpaper()

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

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

Paramètres

  • détails

    objet

    • données

      ArrayBuffer facultatif

      Image de fond d'écran encodée au format JPEG ou PNG sous forme d'ArrayBuffer.

    • filename

      chaîne

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

    • mise en page

      WallpaperLayout

      Mises en page de fond d'écran compatibles.

    • miniature

      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 pris en charge.

    • url

      chaîne facultative

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

  • callback

    function facultatif

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

    (thumbnail?: ArrayBuffer) => void

    • miniature

      ArrayBuffer facultatif

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

Renvoie

  • Promise<ArrayBuffer | undefined>

    Chrome 96 et versions ultérieures

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