chrome.wallpaper

refresh date: 2026-09-25 robots: noindex

คำอธิบาย

ใช้ chrome.wallpaper API เพื่อเปลี่ยนวอลเปเปอร์ ChromeOS

สิทธิ์

wallpaper

ความพร้อมใช้งาน

Chrome 43 ขึ้นไป ChromeOS เท่านั้น

ไฟล์ Manifest

คุณต้องประกาศสิทธิ์ "วอลเปเปอร์" ในไฟล์ Manifest ของแอปเพื่อใช้ API วอลเปเปอร์ เช่น

{
  "name": "My extension",
  ...
  "permissions": [
    "wallpaper"
  ],
  ...
}

ตัวอย่าง

เช่น หากต้องการตั้งวอลเปเปอร์เป็นรูปภาพที่ https://example.com/a_file.png คุณสามารถเรียกใช้ chrome.wallpaper.setWallpaper ด้วยวิธีนี้

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

ประเภท

WallpaperLayout

Chrome 44 ขึ้นไป

เลย์เอาต์วอลเปเปอร์ที่รองรับ

ค่าแจกแจง

"ยืด"

"CENTER"

"CENTER_CROPPED"

เมธอด

setWallpaper()

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

ตั้งค่าวอลเปเปอร์เป็นรูปภาพที่ url หรือ wallpaperData โดยใช้เลย์เอาต์ที่ระบุ

พารามิเตอร์

  • รายละเอียด

    ออบเจ็กต์

    • เพิ่มเติม

      ArrayBuffer ไม่บังคับ

      รูปภาพวอลเปเปอร์ที่เข้ารหัสเป็น jpeg หรือ png เป็น ArrayBuffer

    • ชื่อไฟล์

      สตริง

      ชื่อไฟล์ของวอลเปเปอร์ที่บันทึกไว้

    • เลย์เอาต์

      WallpaperLayout

      เลย์เอาต์วอลเปเปอร์ที่รองรับ

    • ภาพปก

      บูลีน ไม่บังคับ

      จริง หากควรสร้างภาพปกขนาด 128x60 ระบบยังไม่รองรับเลย์เอาต์และสัดส่วน

    • URL

      สตริง ไม่บังคับ

      URL ของวอลเปเปอร์ที่จะตั้งค่า (อาจเป็นแบบสัมพัทธ์)

  • callback

    ฟังก์ชัน ไม่บังคับ

    พารามิเตอร์ callback มีลักษณะดังนี้ 

    (thumbnail?: ArrayBuffer) => void

    • ภาพปก

      ArrayBuffer ไม่บังคับ

      ภาพขนาดย่อของวอลเปเปอร์ที่เข้ารหัส JPEG โดยระบบจะสร้างขึ้นจากการปรับขนาดวอลเปเปอร์เป็น 128x60

การคืนสินค้า

  • Promise<ArrayBuffer | undefined>

    Chrome 96 ขึ้นไป

    ระบบรองรับเฉพาะ Promise สำหรับ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ