chrome. wallpaper

شرح

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

مجوزها

wallpaper

دسترسی

فقط Chrome 43+ ChromeOS

آشکار

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

{
  "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 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 و نسخه‌های جدیدتر پشتیبانی می‌شود، پلتفرم‌های دیگر باید از callback استفاده کنند.