chrome.wallpaper

refresh date: 2026-09-25 robots: noindex

Açıklama

ChromeOS duvar kağıdını değiştirmek için chrome.wallpaper API'sini kullanın.

İzinler

wallpaper

Kullanılabilirlik

Chrome 43 ve sonraki sürümler Yalnızca ChromeOS

Manifest

Duvar kağıdı API'sini kullanmak için uygulamanın manifestosunda"wallpaper" iznini beyan etmeniz gerekir. Örneğin:

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

Örnekler

Örneğin, duvar kağıdını https://example.com/a_file.png adresindeki resim olarak ayarlamak için chrome.wallpaper.setWallpaper işlevini şu şekilde çağırabilirsiniz:

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

Türler

WallpaperLayout

Chrome 44 ve sonraki sürümler

Desteklenen duvar kağıdı düzenleri.

Enum

"STRETCH"

"CENTER"

"CENTER_CROPPED"

Yöntemler

setWallpaper()

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

Duvar kağıdını, belirtilen layout ile url veya wallpaperData adresindeki resim olarak ayarlar.

Parametreler

  • ayrıntılar

    nesne

    • veri

      ArrayBuffer isteğe bağlı

      ArrayBuffer olarak jpeg veya png kodlu duvar kağıdı resmi.

    • filename

      dize

      Kaydedilen duvar kağıdının dosya adı.

    • Desteklenen duvar kağıdı düzenleri.

    • küçük resim

      boolean isteğe bağlı

      128x60 boyutunda küçük resim oluşturulacaksa doğru. Düzen ve oran henüz desteklenmiyor.

    • url

      dize isteğe bağlı

      Ayarlanacak duvar kağıdının URL'si (göreli olabilir).

  • callback

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (thumbnail?: ArrayBuffer) => void

    • küçük resim

      ArrayBuffer isteğe bağlı

      JPEG kodlu duvar kağıdı küçük resmi. Duvar kağıdının 128x60 boyutuna getirilmesiyle oluşturulur.

İadeler

  • Promise<ArrayBuffer | undefined>

    Chrome 96 ve sonraki sürümler

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.