chrome.wallpaper

说明

使用 chrome.wallpaper API 更改 ChromeOS 壁纸。

权限

wallpaper

您必须在应用的清单中声明“wallpaper”权限，才能使用壁纸 API。例如：

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

可用性

Chrome 43 及更高版本 仅限 ChromeOS

示例

例如，如需将壁纸设置为 https://example.com/a_file.png 中的图片，您可以调用 chrome.wallpaper.setWallpaper：

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

类型

WallpaperLayout

Chrome 44 及更高版本

支持的壁纸布局。

枚举

方法

setWallpaper()

Promise 
chrome.wallpaper.setWallpaper(
  details: object,
  callback?: function,
)

使用指定的 layout 将壁纸设置为 url 或 wallpaperData 处的图片

参数

  • 明细

    对象

    • data

      ArrayBuffer 可选

      作为 ArrayBuffer 编码的 jpeg 或 png 壁纸图片。

    • filename

      string

      已保存壁纸的文件名。

    • 支持的壁纸布局。

    • 缩略图

      布尔值 选填

      如果应生成 128x60 的缩略图，则为“true”。尚不支持布局和比例。

    • 网址

      字符串（可选）

      要设置的壁纸的网址（可以是相对网址）。

  • callback

    函数（可选）

    callback 参数如下所示：

    (thumbnail?: ArrayBuffer)=>void

    • 缩略图

      ArrayBuffer 可选

      JPEG 编码的壁纸缩略图。它是通过将壁纸尺寸调整为 128x60 生成的。

返回

  • Promise<ArrayBuffer|undefined>

    Chrome 96 及更高版本

    Manifest V3 及更高版本支持 promise，但提供回调以实现向后兼容性。您不能在同一个函数调用中同时使用这两者。promise 使用传递给回调函数的同一类型进行解析。