chrome.wallpaper

Opis

Użyj interfejsu chrome.wallpaper API, aby zmienić tapetę w ChromeOS.

Uprawnienia

wallpaper

Dostępność

Chrome 43 lub nowszy Tylko ChromeOS

Plik manifestu

Aby korzystać z interfejsu API tapety, musisz zadeklarować uprawnienie „wallpaper” w manifeście aplikacji. Na przykład:

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

Przykłady

Aby na przykład ustawić tapetę jako obraz w lokalizacji https://example.com/a_file.png, możesz wywołać funkcję chrome.wallpaper.setWallpaper w ten sposób:

chrome.wallpaper.setWallpaper(
  {
    'url': 'https://example.com/a_file.jpg',
    'layout': 'CENTER_CROPPED',
    'filename': 'test_wallpaper'
  },
  function() {}
);

Typy

WallpaperLayout

Chrome 44 lub nowszy

Obsługiwane układy tapet.

Typ wyliczeniowy

„STRETCH”

„CENTER”

„CENTER_CROPPED”

Metody

setWallpaper()

Obietnica 
chrome.wallpaper.setWallpaper(
  details: object,
  callback?: function,
): Promise<ArrayBuffer | undefined>

Ustawia tapetę na obraz z parametru url lub wallpaperData z określonym parametrem layout.

Parametry

  • szczegóły

    obiekt

    • dane

      ArrayBuffer opcjonalny

      Obraz tapety zakodowany w formacie JPEG lub PNG jako ArrayBuffer.

    • nazwa pliku

      ciąg znaków

      Nazwa pliku zapisanej tapety.

    • układ : layout (might be used for DTP, web and app design)

      WallpaperLayout

      Obsługiwane układy tapet.

    • miniatura

      wartość logiczna opcjonalna

      Wartość True, jeśli ma zostać wygenerowana miniatura o rozmiarze 128 x 60 pikseli. Układ i proporcje nie są jeszcze obsługiwane.

    • URL

      string opcjonalny

      Adres URL tapety do ustawienia (może być względny).

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    (thumbnail?: ArrayBuffer) => void

    • miniatura

      ArrayBuffer opcjonalny

      Miniatura tapety zakodowana w formacie JPEG. Jest ona generowana przez zmianę rozmiaru tapety na 128 × 60.

Zwroty

  • Promise<ArrayBuffer | undefined>

    Chrome w wersji 96 lub nowszej

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.