browser.wallpaper

شرح

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

اجازه‌ها

wallpaper

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

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

دردسترس بودن

Chrome نسخه ۴۳ و بالاتر browser.* ‎ از Chrome نسخه ۱۴۸ فقط ChromeOS

مثال‌ها

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

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

انواع

WallpaperLayout

Chrome نسخه ۴۴ و بالاتر browser.* از Chrome نسخه ۱۴۸

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

شمارشی

«STRETCH»

"CENTER"

"CENTER_CROPPED"

روش‌ها

setWallpaper()

browser.wallpaper.setWallpaper(
  details: object,
): Promise<ArrayBuffer | undefined>

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

پارامترها

  • جزئیات

    شیء

    • داده

      ArrayBuffer اختیاری

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

    • filename

      رشته

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

    • طرح‌بندی

      WallpaperLayout

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

    • ریزعکس

      بولی اختیاری

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

    • نشانی وب

      رشته اختیاری

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

بازگشتی‌ها

  • Promise<ArrayBuffer | undefined>

    Chrome نسخه ۹۶ و بالاتر browser.* از Chrome نسخه ۱۴۸