تاریخ بهروزرسانی: 2026-09-25 رباتها: noindex
توضیحات
برای تغییر تصویر زمینه ChromeOS از API chrome.wallpaper استفاده کنید.
مجوزها
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
طرحبندیهای تصویر زمینه پشتیبانی شده.
شمارشی
"کشش" «مرکز» "مرکز_برش داده شده"
روشها
setWallpaper()
chrome.wallpaper.setWallpaper(
details: object,
callback?: function,
): Promise<ArrayBuffer | undefined>
تصویر زمینه را روی تصویر موجود در url یا wallpaperData با طرحبندی مشخص شده تنظیم میکند.
پارامترها
- جزئیات
شیء
- دادهها
ArrayBuffer اختیاری
تصویر پسزمینه کدگذاری شده با فرمت jpeg یا png به عنوان یک ArrayBuffer.
- نام فایل
رشته
نام فایل تصویر زمینه ذخیره شده.
- طرح بندی
طرحبندیهای تصویر زمینه پشتیبانی شده.
- تصویر بندانگشتی
بولی اختیاری
اگر قرار است یک تصویر بندانگشتی ۱۲۸x۶۰ ایجاد شود، صحیح است. طرحبندی و نسبت هنوز پشتیبانی نمیشوند.
- آدرس اینترنتی
رشته اختیاری
آدرس اینترنتی (URL) تصویر زمینهای که قرار است تنظیم شود (میتواند نسبی باشد).
- تماس برگشتی
تابع اختیاری
پارامتر
callbackبه شکل زیر است:(thumbnail?: ArrayBuffer) => void
- تصویر بندانگشتی
ArrayBuffer اختیاری
تصویر کوچک تصویر زمینه با کد jpeg. این تصویر با تغییر اندازه تصویر زمینه به 128x60 ایجاد شده است.
بازگشتها
قول <ArrayBuffer | undefined>
کروم ۹۶+Promiseها فقط برای Manifest V3 و نسخههای بعدی پشتیبانی میشوند، سایر پلتفرمها باید از callbackها استفاده کنند.