browser.wallpaper

說明

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

權限

wallpaper

您必須在應用程式的資訊清單中宣告「桌布」權限，才能使用桌布 API。例如：

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

可用性

Chrome 43 以上版本 Chrome 148 以上版本支援 browser.* 僅適用於 ChromeOS

範例

舉例來說，如要將桌布設為 https://example.com/a_file.png 的圖片，可以按照以下方式呼叫 browser.wallpaper.setWallpaper：

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

類型

WallpaperLayout

Chrome 44 以上版本 瀏覽器。*自 Chrome 148 起

支援的桌布版面配置。

列舉

「伸展」

"CENTER"

"CENTER_CROPPED"

方法

setWallpaper()

browser.wallpaper.setWallpaper(
  details: object,
): Promise<ArrayBuffer | undefined>

將桌布設為 url 或 wallpaperData 的圖片，並採用指定的 layout

參數

  • 詳細資料

    物件

    • 資料

      ArrayBuffer 選用

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

    • filename

      字串

      已儲存桌布的檔案名稱。

    • 版面配置

      WallpaperLayout

      支援的桌布版面配置。

    • 縮圖

      布林值 選填

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

    • 網址

      字串 選填

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

傳回

  • Promise<ArrayBuffer | undefined>

    Chrome 96 以上版本 Chrome 148 以上版本中的 browser.*