хром.обои

Описание

Используйте API chrome.wallpaper для смены обоев ChromeOS.

Разрешения

wallpaper

Доступность

Хром 43+ хромео.

Манифест

Чтобы использовать 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_Cropped"

Методы

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.

Возврат

  • Обещание <arraybuffer | неопределенно>

    Хром 96+

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