chrome.wallpaper

Opis

Aby zmienić tapetę ChromeOS, użyj interfejsu API chrome.wallpaper.

Uprawnienia

wallpaper

Aby korzystać z interfejsu Tapeta API, musisz zadeklarować uprawnienie „wallpaper” w pliku manifestu aplikacji. Na przykład:

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

Dostępność

Chrome 43 i nowsze wersje tylko ChromeOS

Przykłady

Aby na przykład ustawić tapetę jako obraz w lokalizacji https://example.com/a_file.png, możesz wywołać metodę 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 i nowsze wersje

Obsługiwane układy tapet.

Enum

"CENTER"

"CENTER_CROPPED"

Metody

setWallpaper()

Obietnica
chrome.wallpaper.setWallpaper(
  details: object,
  callback?: function,
)

Ustawia tapetę z adresu url lub wallpaperData o określonym układzie

Parametry

  • szczegóły

    obiekt

    • dane

      Tablica SlateBuffer opcjonalna

      Obraz tapety w formacie JPEG lub PNG jako obiekt ArrayBuffer.

    • filename

      string,

      Nazwa pliku z zapisaną tapetą.

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

      Obsługiwane układy tapet.

    • miniatura

      wartość logiczna opcjonalna

      Prawda, jeśli powinna zostać wygenerowana miniatura 128 x 60. Układ i współczynnik proporcji nie są jeszcze obsługiwane.

    • URL

      ciąg znaków opcjonalny

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

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak:

    (thumbnail?: ArrayBuffer)=>void

    • miniatura

      Tablica SlateBuffer opcjonalna

      Miniatura tapety w formacie JPEG. Wygenerowany jest po zmianie rozmiaru tapety na 128 x 60.

Akcje powrotne

  • Promise<TrackBuffer|undefined>

    Chrome 96 i nowsze wersje

    Obietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika z tym samym typem, który jest przekazywany do wywołania zwrotnego.