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|undefined>

    Chrome 96+

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

،

شرح

از 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|undefined>

    Chrome 96+

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