chrome.wallpaper

Description

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

Autorisations

wallpaper

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

Disponibilité

Chrome 43 ou version ultérieure ChromeOS uniquement

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