chrome.wallpaper

refresh date: 2026-09-25 robots: noindex

說明

使用 chrome.wallpaper API 變更 ChromeOS 桌布。

權限

wallpaper

可用性

Chrome 43 以上版本 僅適用於 ChromeOS

資訊清單

您必須在應用程式的資訊清單中宣告「桌布」權限，才能使用桌布 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 的圖片，並採用指定的 layout

參數

  • 詳細資料

    物件

    • 資料

      ArrayBuffer 選用

      以 ArrayBuffer 形式呈現的 JPEG 或 PNG 編碼桌布圖片。

    • filename

      字串

      已儲存桌布的檔案名稱。

    • 版面配置

      WallpaperLayout

      支援的桌布版面配置。

    • 縮圖

      布林值 選填

      如果應產生 128x60 縮圖，則為 True。目前不支援版面配置和比例。

    • 網址

      字串 選填

      要設定的桌布網址 (可以是相對網址)。

  • callback

    函式 選填

    callback 參數如下： 

    (thumbnail?: ArrayBuffer) => void

    • 縮圖

      ArrayBuffer 選用

      JPEG 編碼的桌布縮圖。系統會將桌布大小調整為 128x60，產生這張圖片。

傳回

  • Promise<ArrayBuffer | undefined>

    Chrome 96 以上版本

    Promise 僅適用於 Manifest V3 以上版本，其他平台則須使用回呼。