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 manifest dosyasında"duvar kağıdı" 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 yöntemini ş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+

Desteklenen duvar kağıdı düzenleri.

Enum

"STRETCH"

"CENTER"

"CENTER_CROPPED"

Yöntemler

setWallpaper()

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

Duvar kağıdını, belirtilen layout ile url veya wallpaperData konumundaki resme 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

      boole isteğe bağlı

      128x60 boyutunda bir küçük resim oluşturulması gerekiyorsa True değerini alır. Düzen ve oran henüz desteklenmiyor.

    • url

      string isteğe bağlı

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

  • callback

    function isteğe bağlı

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

    (thumbnail?: ArrayBuffer) => void

    • küçük resim

      ArrayBuffer isteğe bağlı

      JPEG olarak kodlanmış duvar kağıdı küçük resmi. Duvar kağıdı 128x60 boyutuna yeniden boyutlandırılarak oluşturulur.

İadeler

  • Promise<ArrayBuffer | undefined>

    Chrome 96+

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.