хром.обои

Описание

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

Разрешения

wallpaper

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

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

Доступность

Chrome 43+ только для ChromeOS

Примеры

Например, чтобы установить обои в качестве изображения по адресу 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

Хром 44+

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

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

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

"ЦЕНТР"

"CENTER_CROPPED"

Методы

setWallpaper()

Обещать
chrome.wallpaper.setWallpaper(
  details: object,
  callback?: function,
)

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

Параметры

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

    объект

    • данные

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

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

    • имя файла

      нить

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

    • макет

      ОбоиМакет

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

    • миниатюра

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

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

    • URL

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

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

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

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

    Параметр callback выглядит так: 

    (thumbnail?: ArrayBuffer) => void

    • миниатюра

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

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

Возврат

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

    Хром 96+

    Промисы поддерживаются в Манифесте V3 и более поздних версиях, но обратные вызовы предусмотрены для обратной совместимости. Вы не можете использовать оба при одном вызове функции. Промис разрешается с тем же типом, который передается в обратный вызов.