chrome.wallpaper

Deskripsi

Gunakan chrome.wallpaper API untuk mengubah wallpaper ChromeOS.

Izin

wallpaper

Anda harus mendeklarasikan "wallpaper" izin dalam manifes aplikasi untuk digunakan API wallpaper. Contoh:

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

Ketersediaan

Chrome 43 dan yang lebih baru Khusus ChromeOS

Contoh

Misalnya, untuk menyetel wallpaper sebagai gambar di https://example.com/a_file.png, Anda dapat menelepon chrome.wallpaper.setWallpaper seperti ini:

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

Jenis

WallpaperLayout

Chrome 44 dan yang lebih baru

Tata letak wallpaper yang didukung.

Enum

"STRETCH"

"PUSAT"

"CENTER_CROPPED"

Metode

setWallpaper()

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

Menyetel wallpaper ke gambar di url atau wallpaperData dengan tata letak yang ditentukan

Parameter

  • detail

    objek

    • data

      ArrayBuffer opsional

      Gambar wallpaper yang dienkode dengan jpeg atau png sebagai ArrayBuffer.

    • filename

      string

      Nama file wallpaper yang disimpan.

    • tata letak

      WallpaperLayout

      Tata letak wallpaper yang didukung.

    • thumbnail

      boolean opsional

      True jika thumbnail berukuran 128x60 harus dibuat. Tata letak dan rasio belum didukung.

    • url

      string opsional

      URL wallpaper yang akan disetel (dapat bersifat relatif).

  • callback

    fungsi opsional

    Parameter callback terlihat seperti ini: 

    (thumbnail?: ArrayBuffer) => void

    • thumbnail

      ArrayBuffer opsional

      Thumbnail wallpaper yang dienkode dengan jpeg. Ukuran ini dibuat dengan mengubah ukuran wallpaper menjadi 128x60.

Hasil

  • Promise<ArrayBuffer | tidak terdefinisi>

    Chrome 96 dan yang lebih baru

    Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.