chrome.wallpaper

الوصف

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

الأذونات

wallpaper

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

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

مدى التوفّر

الإصدار 43 من Chrome أو الإصدارات الأحدث نظام التشغيل 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

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

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

Enum

"توسيع"

"المنتصف"

"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. ويتم إنشاؤه عن طريق تغيير حجم الخلفية إلى 128×60.

المرتجعات

  • Promise<ArrayBuffer | غير محددة>

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

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