توضیحات
از chrome.wallpaper
API برای تغییر کاغذدیواری ChromeOS استفاده کنید.
مجوزها
wallpaper
برای استفاده از 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
طرح بندی تصویر زمینه پشتیبانی شده
Enum
"کشش" "مرکز" "CENTER_CROPPED"
روش ها
setWallpaper()
chrome.wallpaper.setWallpaper(
details: object,
callback?: function,
)
کاغذ دیواری را روی تصویر در آدرس اینترنتی یا wallpaperData با طرح بندی مشخص شده تنظیم می کند
پارامترها
- جزئیات
شی
- داده ها
ArrayBuffer اختیاری است
تصویر کاغذدیواری رمزگذاری شده jpeg یا png به عنوان یک ArrayBuffer.
- نام فایل
رشته
نام فایل تصویر زمینه ذخیره شده.
- طرح بندی
طرح بندی تصویر زمینه پشتیبانی شده
- تصویر کوچک
بولی اختیاری
درست است اگر یک تصویر کوچک 128x60 ایجاد شود. طرح بندی و نسبت هنوز پشتیبانی نمی شود.
- آدرس اینترنتی
رشته اختیاری
URL تصویر زمینه تنظیم شده (می تواند نسبی باشد).
- پاسخ به تماس
عملکرد اختیاری
پارامتر
callback
به نظر می رسد:(thumbnail?: ArrayBuffer) => void
- تصویر کوچک
ArrayBuffer اختیاری است
تصویر بندانگشتی تصویر زمینه کدگذاری شده jpeg. با تغییر اندازه کاغذ دیواری به 128x60 ایجاد می شود.
برمی گرداند
Promise<ArrayBuffer | تعریف نشده>
Chrome 96+Promises در Manifest V3 و نسخه های جدیدتر پشتیبانی می شود، اما callbacks برای سازگاری به عقب ارائه شده است. شما نمی توانید از هر دو در یک فراخوانی تابع استفاده کنید. وعده با همان نوعی که به callback ارسال می شود حل می شود.