chrome.wallpaper

說明

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

權限

wallpaper

您必須聲明「桌布」應用程式資訊清單中要使用的權限 桌布 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 以上版本

支援的桌布版面配置。

列舉

"STRETCH"

"CENTER"

"CENTER_CROPPED"

方法

setWallpaper()

Promise 
chrome.wallpaper.setWallpaper(
  details: object,
  callback?: function,
)

將桌布設為 url 或 wallpaperData 搭配指定的layout

參數

  • 詳細資料

    物件

    • 資料

      ArrayBuffer 選用

      以 ArrayBuffer 格式使用 jpeg 或 png 編碼的桌布圖片。

    • filename

      字串

      已儲存桌布的檔案名稱。

    • 版面配置

      WallpaperLayout

      支援的桌布版面配置。

    • thumbnail

      布林值 選填

      如果必須產生 128 x 60 的縮圖，則為 True。目前不支援版面配置和比例。

    • 網址

      string optional

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

  • 回呼

    函式 選用

    callback 參數如下所示： 

    (thumbnail?: ArrayBuffer) => void

    • thumbnail

      ArrayBuffer 選用

      JPEG 編碼的桌布縮圖。將桌布調整為 128 x 60 大小即可產生成果。

傳回

  • Promise<ArrayBuffer |未定義>

    Chrome 96 以上版本

    Promise 適用於 Manifest V3 及以上版本，但系統會為 回溯相容性您無法在同一函式呼叫中同時使用兩者。 保證會以傳遞至回呼的相同類型來解析。