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é
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
Dispositions de fond d'écran compatibles.
Enum
"CENTER_CROPPED"
Méthodes
setWallpaper()
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
-
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
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érieuresLes 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.