chrome.wallpaper

Mô tả

Dùng API chrome.wallpaper để thay đổi hình nền ChromeOS.

Quyền

wallpaper

Bạn phải khai báo "hình nền" quyề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

Chrome 43 trở lên Chỉ ChromeOS

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 này:

chrome.wallpaper.setWallpaper(
  {
    'url': 'https://example.com/a_file.jpg',
    'layout': 'CENTER_CROPPED',
    'filename': 'test_wallpaper'
  },
  function() {}
);

Loại

WallpaperLayout

Chrome 44 trở lên

Bố cục hình nền được hỗ trợ.

Enum

"HÀI HƯỚC"

"CENTER"

"CENTER_CROPPED"

Phương thức

setWallpaper()

Lời hứa 
chrome.wallpaper.setWallpaper(
  details: object,
  callback?: function,
)

Đặt hình nền cho hình ảnh tại url hoặc wallpaperData với bố cục được chỉ định

Tham số

  • chi tiết

    đối tượng

    • dữ liệu

      ArrayBuffer không bắt buộc

      Hình nền được 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

      WallpaperLayout

      Bố cục hình nền được hỗ trợ.

    • hình thu nhỏ

      boolean không bắt buộc

      Đúng nếu bạn muốn tạo hình thu nhỏ có kích thước 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 thay đổi kích thước hình nền thành 128x60.

Giá trị trả về

  • Promise<ArrayBuffer | không xác định>

    Chrome 96 trở lên

    Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp cho 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. Chiến lược phát hành đĩa đơn Promise phân giải cùng loại được truyền đến lệnh gọi lại.