chrome.wallpaper

refresh date: 2026-09-25 robots: noindex

شرح

از میانای برنامه‌سازی کاربردی chrome.wallpaper برای تغییر کاغذدیواری ChromeOS استفاده کنید.

اجازه‌ها

wallpaper

دردسترس بودن

Chrome نسخه ۴۳ به بالا فقط ChromeOS

مانیفست

برای استفاده از میانای برنامه‌سازی کاربردی کاغذدیواری، باید اجازه «کاغذدیواری» را در مانیفست برنامه اعلام کنید. برای مثال:

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

مثال‌ها

برای مثال، برای تنظیم کاغذدیواری به‌عنوان تصویر در https://example.com/a_file.png، می‌توانید chrome.wallpaper.setWallpaper را به این روش فراخوانی کنید:

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

انواع

WallpaperLayout

Chrome نسخه ۴۴ به بالا

چیدمان‌های کاغذدیواری پشتیبانی‌شده.

شمارشی

«STRETCH»

"CENTER"

"CENTER_CROPPED"

روش‌ها

setWallpaper()

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

کاغذدیواری را روی تصویر در url یا wallpaperData با layout مشخص‌شده تنظیم می‌کند

پارامترها

  • جزئیات

    شیء

    • داده

      ArrayBuffer اختیاری

      تصویر کاغذدیواری کدبندی‌شده jpeg یا png به‌عنوان ArrayBuffer.

    • filename

      رشته

      نام فایل کاغذدیواری ذخیره‌شده.

    • طرح‌بندی

      WallpaperLayout

      چیدمان‌های کاغذدیواری پشتیبانی‌شده.

    • ریزعکس

      بولی اختیاری

      اگر ریزعکس ۱۲۸×۶۰ باید تولید شود، درست است. چیدمان و نسبت هنوز پشتیبانی نمی‌شود.

    • نشانی وب

      رشته اختیاری

      نشانی وب کاغذدیواری‌ای که باید تنظیم شود (می‌تواند نسبی باشد).

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به‌صورت زیر است: 

    (thumbnail?: ArrayBuffer) => void

    • ریزعکس

      ArrayBuffer اختیاری

      ریزعکس کاغذدیواری کدگذاری‌شده jpeg. این تصویر با تغییر اندازه کاغذدیواری به ۱۲۸×۶۰ تولید می‌شود.

بازگشتی‌ها

  • Promise<ArrayBuffer | undefined>

    Chrome نسخه ۹۶ به بالا

    ‫Promises فقط برای «مانیفست نسخه ۳» و نسخه‌های جدیدتر پشتیبانی می‌شود، پلاتفرم‌های دیگر باید از callbacks استفاده کنند.