хром.обои

дата обновления: 2026-09-25 robots: noindex

Описание

Используйте API chrome.wallpaper для смены обоев 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+

Поддерживаемые варианты оформления обоев.

Перечисление

"ПОТЯГИВАТЬСЯ"

"ЦЕНТР"

"CENTER_CROPTED"

Методы

setWallpaper()

Обещать
chrome.wallpaper.setWallpaper(
  details: object,
  callback?: function,
): Promise<ArrayBuffer | undefined>

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

Параметры

  • подробности

    объект

    • данные

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

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

    • имя файла

      нить

      Имя файла сохранённых обоев.

    • макет

      WallpaperLayout

      Поддерживаемые варианты оформления обоев.

    • миниатюра

      логический необязательный

      Значение True, если необходимо сгенерировать миниатюру размером 128x60 пикселей. Макет и соотношение сторон пока не поддерживаются.

    • url

      строка необязательный

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

  • перезвонить

    функция необязательна

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

    (thumbnail?: ArrayBuffer) => void

    • миниатюра

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

      Миниатюра обоев в формате JPEG. Она создается путем изменения размера обоев до 128x60 пикселей.

Возвраты

  • Promise<ArrayBuffer | undefined>

    Chrome 96+

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.