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()

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

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

参数

  • 详细信息

    对象

    • 数据

      ArrayBuffer 可选

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

    • filename

      字符串

      已保存壁纸的文件名。

    • 支持的壁纸布局。

    • 缩略图

      布尔值（可选）

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

    • 网址

      字符串（选填）

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

返回

  • Promise<ArrayBuffer | undefined>

    Chrome 96 及更高版本