browser.wallpaper

الوصف

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

الأذونات

wallpaper

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

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

مدى التوفّر

الإصدار 43 من Chrome والإصدارات الأحدث browser.* ‎ منذ الإصدار 148 من Chrome نظام التشغيل Chrome فقط

أمثلة

على سبيل المثال، لضبط الخلفية على الصورة في https://example.com/a_file.png، يمكنك استدعاء browser.wallpaper.setWallpaper بهذه الطريقة:

browser.wallpaper.setWallpaper(
  {
    'url': 'https://example.com/a_file.jpg',
    'layout': 'CENTER_CROPPED',
    'filename': 'test_wallpaper'
  },
  function() {}
);

الأنواع

WallpaperLayout

الإصدار 44 من Chrome والإصدارات الأحدث browser.* ‎ منذ الإصدار 148 من Chrome

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

Enum

"STRETCH"

"CENTER"

"CENTER_CROPPED"

الطُرق

setWallpaper()

browser.wallpaper.setWallpaper(
  details: object,
): Promise<ArrayBuffer | undefined>

يضبط هذا الإجراء الخلفية على الصورة في url أو wallpaperData باستخدام layout المحدّد

المعلمات

  • التفاصيل

    عنصر

    • البيانات

      ‫ArrayBuffer اختياري

      صورة الخلفية المرمّزة بتنسيق jpeg أو png كـ ArrayBuffer

    • filename

      سلسلة

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

    • التصميم

      WallpaperLayout

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

    • صورة مصغّرة

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

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

    • url

      string اختياري

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

المرتجعات

  • Promise<ArrayBuffer | undefined>

    الإصدار 96 من Chrome والإصدارات الأحدث browser.* ‎ منذ الإصدار 148 من Chrome