الوصف
يمكنك استخدام واجهة برمجة التطبيقات 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 والإصدارات الأحدثتتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.