chrome.wallpaper

说明

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

权限

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 及更高版本

支持的壁纸版式。

枚举

“STRETCH”

"CENTER"

"CENTER_CROPPED"

方法

setWallpaper()

<ph type="x-smartling-placeholder"></ph> 承诺 
chrome.wallpaper.setWallpaper(
  details: object,
  callback?: function,
)

将壁纸设置为位于 url 或 wallpaperData 且具有指定的 layout 的图片

参数

  • 详细信息

    对象

    • 数据

      ArrayBuffer 可选

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

    • filename

      字符串

      已保存壁纸的文件名。

    • 支持的壁纸版式。

    • 缩略图

      布尔值（可选）

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

    • 网址

      字符串（可选）

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

  • callback

    函数（可选）

    callback 参数如下所示： 

    (thumbnail?: ArrayBuffer) => void

    • 缩略图

      ArrayBuffer 可选

      采用 jpeg 编码的壁纸缩略图。它会将壁纸大小调整为 128x60 来生成。

返回

  • Promise&lt;ArrayBuffer |未定义>

    Chrome 96 及更高版本

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