chrome.wallpaper

refresh date: 2026-09-25 robots: noindex

Mô tả

Sử dụng API chrome.wallpaper để thay đổi hình nền ChromeOS.

Quyền

wallpaper

Phạm vi cung cấp

Chrome 43 trở lên Chỉ ChromeOS

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

"STRETCH"

"CENTER"

"CENTER_CROPPED"

Phương thức

setWallpaper()

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

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

Thông số

  • chi tiết

    đối tượng

    • khác

      Không bắt buộc ArrayBuffer

      Hình nền được mã hoá dưới 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

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

    • hình thu nhỏ

      boolean không bắt buộc

      True nếu cần tạo hình thu nhỏ 128x60. Chưa hỗ trợ bố cục và tỷ lệ.

    • 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).

  • callback

    hàm không bắt buộc

    Tham số callback có dạng như sau: 

    (thumbnail?: ArrayBuffer) => void

    • hình thu nhỏ

      Không bắt buộc ArrayBuffer

      Hình thu nhỏ của hình nền được mã hoá jpeg. Hình thu nhỏ này đượ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ên

    Lờ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.