说明
使用 chrome.wallpaper
API 更改 ChromeOS 壁纸。
权限
wallpaper
可用性
Chrome 43 及更高版本
仅限 ChromeOS
清单
您必须在应用的清单中声明“wallpaper”权限,才能使用壁纸 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 及更高版本
支持的壁纸布局。
枚举
方法
setWallpaper()
Promise
chrome.wallpaper.setWallpaper(
details: object,
callback?: function,
)
使用指定的 layout 将壁纸设置为 url 或 wallpaperData 处的图片
参数
-
详细信息
对象
-
data
ArrayBuffer 可选
作为 ArrayBuffer 编码的 jpeg 或 png 壁纸图片。
-
filename
string
已保存壁纸的文件名。
-
layout
支持的壁纸布局。
-
缩略图
布尔值 选填
如果应生成 128x60 的缩略图,则为“true”。尚不支持布局和比例。
-
网址
字符串(可选)
要设置的壁纸的网址(可以是相对网址)。
-
-
callback
函数(可选)
callback
参数如下所示:(thumbnail?: ArrayBuffer) => void
-
缩略图
ArrayBuffer 可选
JPEG 编码的壁纸缩略图。它是通过将壁纸尺寸调整为 128x60 生成的。
-
返回
-
Promise<ArrayBuffer | undefined>
Chrome 96 及更高版本只有 Manifest V3 及更高版本支持 Promise,其他平台需要使用回调。