chrome.wallpaper

更新日: 2026-09-25 robots: noindex

説明

chrome.wallpaper API を使用して ChromeOS の壁紙を変更します。

権限

wallpaper

対象

Chrome 43 以降 ChromeOS のみ

マニフェスト

壁紙 API を使用するには、アプリのマニフェストで「壁紙」権限を宣言する必要があります。次に例を示します。

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

例

たとえば、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,
): Promise<ArrayBuffer | undefined>

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

パラメータ

  • 詳細

    オブジェクト

    • データ

      ArrayBuffer 省略可

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

    • filename

      文字列

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

    • レイアウト

      WallpaperLayout

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

    • サムネイル

      boolean 省略可

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

    • URL

      文字列 省略可

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

  • callback

    function 省略可

    callback パラメータは次のようになります。 

    (thumbnail?: ArrayBuffer) => void

    • サムネイル

      ArrayBuffer 省略可

      JPEG でエンコードされた壁紙のサムネイル。壁紙を 128x60 にサイズ変更して生成されます。

戻り値

  • Promise<ArrayBuffer | undefined>

    Chrome 96 以降

    Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。