browser.wallpaper

الوصف

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

الأذونات

wallpaper

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

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

مدى التوفّر

الإصدار 43 من Chrome والإصدارات الأحدث نظام التشغيل ChromeOS فقط

أمثلة

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

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

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

تعداد

"STRETCH"

"CENTER"

"CENTER_CROPPED"

الطُرق

setWallpaper()

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

يضبط خلفية الشاشة على الصورة في عنوان URL أو wallpaperData مع التصميم المحدّد

المعلمات

  • التفاصيل

    عنصر

    • البيانات

      ‫ArrayBuffer اختياري

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

    • filename

      سلسلة

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

    • التصميم

      WallpaperLayout

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

    • صورة مصغّرة

      boolean اختياري

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

    • url

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

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

المرتجعات

  • Promise<ArrayBuffer | undefined>

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