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 以上版本

支援的桌布版面配置。

列舉

方法

setWallpaper()

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

使用指定的版面配置將桌布設為 url 或 wallpaperData 的圖片。

參數

  • 詳細資料

    物件

    • 資料或曾存取這類資料的人員

      ArrayBuffer 選用

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

    • filename

      字串

      已儲存桌布的檔案名稱。

    • 版面配置

      WallpaperLayout

      支援的桌布版面配置。

    • thumbnail

      布林值 (選用)

      如果要產生 128x60 的縮圖，則為 True。尚不支援版面配置和比率。

    • url

      字串 選用

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

  • 回呼

    函式選用

    callback 參數如下所示： 

    (thumbnail?: ArrayBuffer)=>void

    • thumbnail

      ArrayBuffer 選用

      jpeg 編碼的桌布縮圖。讓系統將桌布調整為 128x60。

傳回

  • Promise<ArrayBuffer|undefined>

    Chrome 96 以上版本

    Manifest V3 以上版本支援 Promise，但是為了提供回溯相容性而提供的回呼。您無法在同一個函式呼叫中同時使用這兩者。承諾會用傳遞至回呼的同類型解析。