chrome.wallpaper

說明

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

權限

wallpaper

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

{
  "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()

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

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

參數

  • 詳細資料

    物件

    • 資料

      ArrayBuffer 選填

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

    • filename

      字串

      已儲存桌布的檔案名稱。

    • 版面配置

      WallpaperLayout

      支援的桌布版面配置。

    • 縮圖

      布林值 選填

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

    • 網址

      字串 選填

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

傳回

  • Promise<ArrayBuffer | undefined>

    Chrome 96 以上版本