chrome.wallpaper

الوصف

يمكنك استخدام واجهة برمجة التطبيقات chrome.wallpaper لتغيير خلفية نظام التشغيل ChromeOS.

الأذونات

wallpaper

يجب تقديم إذن "الخلفية" في بيان التطبيق لاستخدام واجهة برمجة التطبيقات الخاصة بالخلفية. مثال:

{
  "name": "My extension",
  ...
  "permissions": [
    "wallpaper"
  ],
  ...
}

مدى توفّر الخدمة

Chrome 43 والإصدارات الأحدث ChromeOS فقط

أمثلة

على سبيل المثال، لضبط الخلفية كصورة في 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

Chrome 44 والإصدارات الأحدث

تنسيقات الخلفيات المتوافقة

التعداد

"CENTER_CROPPED"

الطُرق

setWallpaper()

وعد 
chrome.wallpaper.setWallpaper(
  details: object,
  callback?: function,
)

لضبط الخلفية على الصورة في url أو wallpaperData بالتنسيق المحدَّد

المَعلمات

  • التفاصيل

    كائن

    • البيانات

      ArrayBuffer اختيارية

      صورة خلفية بترميز jpeg أو png على شكل ArrayBuffer.

    • filename

      سلسلة

      اسم ملف الخلفية المحفوظة

    • التصميم

      WallpaperLayout

      تنسيقات الخلفيات المتوافقة

    • thumbnail

      منطقية اختيارية

      صحيح إذا كان يجب إنشاء صورة مصغّرة بحجم 128×60. التنسيق والنسبة غير متاحتَين بعد.

    • url

      سلسلة اختيارية

      عنوان URL للخلفية المطلوب ضبطها (يمكن أن يكون نسبيًا).

  • معاودة الاتصال

    الدالة اختيارية

    تبدو معلَمة callback على النحو التالي: 

    (thumbnail?: ArrayBuffer)=>void

    • thumbnail

      ArrayBuffer اختيارية

      صورة مصغّرة لخلفية بترميز jpeg. ويتم إنشاؤه من خلال تغيير حجم الخلفية إلى 128x60.

المرتجعات

  • الوعد<ArrayBuffer|غير محدّد>

    Chrome 96 والإصدارات الأحدث

    تتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.