chrome.wallpaper

الوصف

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

الأذونات

wallpaper

مدى التوفّر

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

البيان

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

{
  "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

الإصدار 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 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.