chrome.wallpaper

Mô tả

Sử 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

Chrome 43 trở lên Chỉ dành cho 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

Các bố cục hình nền được hỗ trợ.

Enum

"STRETCH"

"CENTER"

"CENTER_CROPPED"

Phương thức

setWallpaper()

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

Đặt hình nền thành hình ảnh tại url hoặc wallpaperData với layout được chỉ định

Thông số

  • chi tiết

    đối tượng

    • khác

      ArrayBuffer không bắt buộc

      Hình nền được mã hoá ở định dạng jpeg hoặc png dưới dạng ArrayBuffer.

    • filename

      chuỗi

      Tên tệp của hình nền đã lưu.

    • bố cục

      WallpaperLayout

      Các bố cục hình nền được hỗ trợ.

    • hình thu nhỏ

      boolean không bắt buộc

      True 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à URL tương đối).

Giá trị trả về

  • Promise<ArrayBuffer | undefined>

    Chrome 96 trở lên