chrome.wallpaper

refresh date: 2026-09-25 robots: noindex

Описание

Используйте chrome.wallpaper API, чтобы изменить обои ChromeOS.

Разрешения

wallpaper

Доступность

Chrome 43 и более поздних версий Только ChromeOS

Манифест

Чтобы использовать API обоев, необходимо объявить разрешение wallpaper в манифесте приложения. Пример:

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

Устанавливает в качестве обоев изображение, указанное в параметре url или wallpaperData, с заданным макетом layout.

Параметры

  • подробные сведения

    Объект

    • делал.

      ArrayBuffer (необязательно)

      Изображение обоев в формате JPEG или PNG в виде ArrayBuffer.

    • filename

      string

      Название файла сохраненных обоев.

    • макет

      WallpaperLayout

      Поддерживаемые макеты обоев.

    • значок

      Логическое значение (необязательно)

      True, если нужно создать значок размером 128 x 60. Макет и соотношение сторон пока не поддерживаются.

    • url

      Строка (необязательно)

      URL обоев, которые нужно установить (может быть относительным).

  • обратный вызов

    function необязательно

    Параметр callback выглядит следующим образом: 

    (thumbnail?: ArrayBuffer) => void

    • значок

      ArrayBuffer (необязательно)

      Значок обоев в формате JPEG. Оно создается путем изменения размера обоев до 128 x 60.

Возвраты

  • Promise<ArrayBuffer | undefined>

    Chrome 96 и более поздних версий;

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.