الوصف
يمكنك استخدام واجهة برمجة التطبيقات chrome.wallpaper
لتغيير خلفية نظام التشغيل ChromeOS.
الأذونات
wallpaper
مدى التوفّر
البيان
يجب تقديم إذن "الخلفية" في بيان التطبيق لاستخدام واجهة برمجة التطبيقات الخاصة بالخلفية. مثلاً:
{
"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
تنسيقات الخلفيات المتوافقة
التعداد
"CENTER_CROPPED"
الطُرق
setWallpaper()
chrome.wallpaper.setWallpaper(
details: object,
callback?: function,
)
لضبط الخلفية على الصورة في url أو wallpaperData بالتنسيق المحدَّد
المَعلمات
-
التفاصيل
عنصر
-
البيانات
ArrayBuffer اختيارية
صورة خلفية بترميز jpeg أو png على شكل ArrayBuffer.
-
filename
سلسلة
اسم ملف الخلفية المحفوظة
-
التصميم
تنسيقات الخلفيات المتوافقة
-
thumbnail
منطقية اختيارية
صحيح إذا كان يجب إنشاء صورة مصغّرة بحجم 128×60. التنسيق والنسبة غير متاحتَين بعد.
-
url
سلسلة اختيارية
عنوان URL للخلفية المطلوب ضبطها (يمكن أن يكون نسبيًا).
-
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(thumbnail?: ArrayBuffer) => void
-
thumbnail
ArrayBuffer اختيارية
صورة مصغّرة لخلفية بترميز jpeg. ويتم إنشاؤه من خلال تغيير حجم الخلفية إلى 128x60.
-
المرتجعات
-
Promise<ArrayBuffer | undefined>
Chrome 96 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.