chrome.wallpaper

.

Opis

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

Uprawnienia

wallpaper

Musisz zadeklarować tapetę uprawnienia w pliku manifestu aplikacji z tapetą w interfejsie API. Na przykład:

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

Dostępność

Chrome w wersji 43 lub nowszej Tylko ChromeOS

Przykłady

Aby na przykład ustawić tapetę jako obraz w https://example.com/a_file.png, możesz zadzwonić pod numer chrome.wallpaper.setWallpaper w następujący sposób:

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

Typy

WallpaperLayout

Chrome w wersji 44 lub nowszej

Obsługiwane układy tapet.

Typ wyliczeniowy

"ROZCIĄGNIĘCIE"

"CENTER"

"CENTER_CROPPED"

Metody

setWallpaper()

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

Ustawia tapetę obrazu pod adresem url lub wallpaperData z określonym układem

Parametry

  • szczegóły

    Obiekt

    • dane

      SlateBuffer opcjonalnie

      Obraz tapety w formacie JPEG lub PNG w formacie SlateBuffer.

    • nazwa pliku

      ciąg znaków

      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 ma zostać wygenerowana miniatura o wymiarach 128 x 60. Układ i proporcje nie są jeszcze obsługiwane.

    • URL

      ciąg znaków opcjonalny

      Adres URL tapety, którą chcesz ustawić (może być względny).

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak:

    (thumbnail?: ArrayBuffer) => void
    .

    • miniatura

      SlateBuffer opcjonalnie

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

Zwroty

  • Promise<ArrayBuffer | niezdefiniowane>

    Chrome 96 lub nowszy

    Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.