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 以降の browser.*

サポートされている壁紙のレイアウト。

列挙型

"STRETCH"

"CENTER"

"CENTER_CROPPED"

メソッド

setWallpaper()

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

指定された layout で、url または wallpaperData の画像に壁紙を設定します。

パラメータ

  • 詳細

    オブジェクト

    • データ

      ArrayBuffer 省略可

      jpeg または png でエンコードされた壁紙画像（ArrayBuffer 形式）。

    • filename

      文字列

      保存した壁紙のファイル名。

    • レイアウト

      WallpaperLayout

      サポートされている壁紙のレイアウト。

    • サムネイル

      boolean 省略可

      128x60 のサムネイルを生成する場合は true。レイアウトと比率はまだサポートされていません。

    • URL

      文字列 省略可

      設定する壁紙の URL（相対 URL も可）。

戻り値

  • Promise<ArrayBuffer | undefined>

    Chrome 96 以降 Chrome 148 以降の browser.*