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