chrome.wallpaper

说明

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

权限

wallpaper

可用性

Chrome 43 及更高版本 仅限 ChromeOS

清单

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

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

示例

例如，如需将壁纸设置为 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 及更高版本

支持的壁纸布局。

枚举

"STRETCH"

"CENTER"

"CENTER_CROPPED"

方法

setWallpaper()

Promise 
chrome.wallpaper.setWallpaper(
  details: object,
  callback?: function,
): Promise<ArrayBuffer | undefined>

将壁纸设置为 url 或 wallpaperData 中的图片，并采用指定的布局

参数

  • 详细信息

    对象

    • 数据

      ArrayBuffer 可选

      以 ArrayBuffer 形式表示的 JPEG 或 PNG 编码壁纸图片。

    • filename

      字符串

      已保存壁纸的文件名。

    • 支持的壁纸布局。

    • 缩略图

      布尔值（可选）

      如果应生成 128x60 缩略图，则为 True。尚不支持布局和宽高比。

    • 网址

      字符串（选填）

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

  • callback

    函数 可选

    callback 参数如下所示： 

    (thumbnail?: ArrayBuffer) => void

    • 缩略图

      ArrayBuffer 可选

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

返回

  • Promise<ArrayBuffer | undefined>

    Chrome 96 及更高版本

    仅 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。