Nội dung mô tả
Dùng API chrome.wallpaper
để thay đổi hình nền ChromeOS.
Quyền
wallpaper
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"
],
...
}
Phạm vi cung cấp
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 được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp để có khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Lời hứa sẽ được phân giải bằng cùng một loại được truyền đến lệnh gọi lại.