Nội dung mô tả
Dùng API chrome.wallpaper
để thay đổi hình nền ChromeOS.
Quyền
wallpaper
Phạm vi cung cấp
Tệp kê khai
Bạn phải khai báo quyền "hình nền" trong tệp kê khai của ứng dụng để sử dụng API hình nền. Ví dụ:
{
"name": "My extension",
...
"permissions": [
"wallpaper"
],
...
}
Ví dụ
Ví dụ: để đặt hình nền làm hình ảnh tại https://example.com/a_file.png
, bạn có thể gọi chrome.wallpaper.setWallpaper
theo cách sau:
chrome.wallpaper.setWallpaper(
{
'url': 'https://example.com/a_file.jpg',
'layout': 'CENTER_CROPPED',
'filename': 'test_wallpaper'
},
function() {}
);
Loại
WallpaperLayout
Bố cục hình nền được hỗ trợ.
Liệt kê
"CENTER_CROPPED"
Phương thức
setWallpaper()
chrome.wallpaper.setWallpaper(
details: object,
callback?: function,
)
Đặt hình nền cho hình ảnh tại url hoặc wallpaperData bằng bố cục đã chỉ định
Tham số
-
chi tiết
đối tượng
-
data
ArrayBuffer không bắt buộc
Hình nền mã hoá jpeg hoặc png dưới dạng ArrayBuffer.
-
filename
string
Tên tệp của hình nền đã lưu.
-
bố cục
Bố cục hình nền được hỗ trợ.
-
hình thu nhỏ
boolean không bắt buộc
Đúng nếu cần tạo hình thu nhỏ 128x60. Bố cục và tỷ lệ chưa được hỗ trợ.
-
url
chuỗi không bắt buộc
URL của hình nền cần đặt (có thể là tương đối).
-
-
số gọi lại
hàm không bắt buộc
Tham số
callback
sẽ có dạng như sau:(thumbnail?: ArrayBuffer) => void
-
hình thu nhỏ
ArrayBuffer không bắt buộc
Hình thu nhỏ của hình nền được mã hoá jpeg. Nó được tạo bằng cách đổi kích thước hình nền thành 128x60.
-
Giá trị trả về
-
Promise<ArrayBuffer | undefined>
Chrome 96 trở lênLời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.