chrome.wallpaper

คำอธิบาย

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

สิทธิ์

wallpaper

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

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

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

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

ตัวอย่าง

เช่น หากต้องการตั้งค่าวอลเปเปอร์เป็นรูปภาพที่ 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()

สัญญา
chrome.wallpaper.setWallpaper(
  details
: object,
  callback
?: function,
)

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

พารามิเตอร์

  • รายละเอียด

    ออบเจ็กต์

    • ข้อมูล

      ArrayBuffer ไม่บังคับ

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

    • ชื่อไฟล์

      สตริง

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

    • เลย์เอาต์

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

    • ภาพขนาดย่อ

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

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

    • URL

      string ไม่บังคับ

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

  • Callback

    ไม่บังคับ

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

    (thumbnail?: ArrayBuffer) => void

    • ภาพขนาดย่อ

      ArrayBuffer ไม่บังคับ

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

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

  • Promise<ArrayBuffer | ไม่ระบุ>

    Chrome 96 ขึ้นไป

    รองรับคำสัญญาในไฟล์ Manifest V3 ขึ้นไป แต่จะมี Callback สำหรับ ความเข้ากันได้แบบย้อนหลัง คุณไม่สามารถใช้ทั้ง 2 อย่างในการเรียกใช้ฟังก์ชันเดียวกันได้ จะมีการแก้ไขด้วยประเภทเดียวกันที่ส่งไปยัง Callback