chrome.wallpaper

Description

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

Autorisations

wallpaper

Disponibilité

Chrome 43 ou version ultérieure ChromeOS uniquement

Fichier manifeste

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

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

Exemples

Par exemple, pour définir le fond d'écran comme image https://example.com/a_file.png, vous pouvez appeler chrome.wallpaper.setWallpaper de cette façon:

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

Types

WallpaperLayout

Chrome (version 44 ou ultérieure)

Mises en page de fond d'écran compatibles.

Énumération

"STRETCH"

"CENTER"

"CENTER_CROPPED"

Méthodes

setWallpaper()

<ph type="x-smartling-placeholder"></ph> 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 layout spécifiée.

Paramètres

  • détails

    objet

    • données

      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

      Mises en page 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

      chaîne facultatif

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

  • rappel

    function facultatif

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

    (thumbnail?: ArrayBuffer) => void

    • thumbnail

      ArrayBuffer facultatif

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

Renvoie

  • Promise&lt;ArrayBuffer | indéfini>

    Chrome 96 ou version ultérieure

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