chrome. wallpaper

توضیحات

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

مجوزها

wallpaper

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

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

در دسترس بودن

فقط Chrome 43+ ChromeOS

نمونه ها

به عنوان مثال، برای تنظیم تصویر زمینه به عنوان تصویر در 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 44+

طرح بندی تصویر زمینه پشتیبانی شده

Enum

"کشش"

"مرکز"

"CENTER_CROPPED"

روش ها

setWallpaper()

قول بده
chrome.wallpaper.setWallpaper(
  details: object,
  callback?: function,
)

کاغذ دیواری را روی تصویر در آدرس اینترنتی یا wallpaperData با طرح بندی مشخص شده تنظیم می کند

پارامترها

  • جزئیات

    شی

    • داده ها

      ArrayBuffer اختیاری است

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

    • نام فایل

      رشته

      نام فایل تصویر زمینه ذخیره شده.

    • طرح بندی

      Wallpaper Layout

      طرح بندی تصویر زمینه پشتیبانی شده

    • تصویر کوچک

      بولی اختیاری

      درست است اگر یک تصویر کوچک 128x60 ایجاد شود. طرح بندی و نسبت هنوز پشتیبانی نمی شود.

    • آدرس اینترنتی

      رشته اختیاری

      URL تصویر زمینه تنظیم شده (می تواند نسبی باشد).

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد: 

    (thumbnail?: ArrayBuffer) => void

    • تصویر کوچک

      ArrayBuffer اختیاری است

      تصویر بندانگشتی تصویر زمینه کدگذاری شده jpeg. با تغییر اندازه کاغذ دیواری به 128x60 ایجاد می شود.

برمی گرداند

  • Promise<ArrayBuffer | تعریف نشده>

    Chrome 96+

    Promises در Manifest V3 و نسخه های جدیدتر پشتیبانی می شود، اما callbacks برای سازگاری به عقب ارائه شده است. شما نمی توانید از هر دو در یک فراخوانی تابع استفاده کنید. وعده با همان نوعی که به callback ارسال می شود حل می شود.