chrome.wallpaper

refresh date: 2026-09-25 robots: noindex

Opis

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

Uprawnienia

wallpaper

Dostępność

Chrome 43 lub nowsza wersja Tylko w systemie 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

Jeśli na przykład chcesz ustawić jako tapetę obraz z lokalizacji https://example.com/a_file.png, możesz wywołać 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 nowsza wersja

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 pod adresem url lub wallpaperData z określonym layout

Parametry

  • szczegóły

    obiekt

    • dane

      ArrayBuffer opcjonalny

      Obraz tapety zakodowany w formacie JPEG lub PNG jako ArrayBuffer.

    • nazwa pliku

      tekst

      Nazwa pliku zapisanej tapety.

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

      WallpaperLayout

      Obsługiwane układy tapet.

    • miniatura

      boolean opcjonalne

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

    • URL

      ciąg znaków opcjonalny

      Adres URL tapety, która ma zostać ustawiona (może być względny).

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    (thumbnail?: ArrayBuffer) => void

    • miniatura

      ArrayBuffer opcjonalny

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

Zwroty

  • Promise<ArrayBuffer | undefined>

    Chrome 96 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.