chrome.wallpaper

Description

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

Autorisations

wallpaper

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"
  ],
  ...
}

Garantie de disponibilité

Chrome 43 et versions ultérieures ChromeOS uniquement

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 sont compatibles avec Manifest V3 et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse est résolue avec le même type que celui transmis au rappel.