chrome.wallpaper

refresh date: 2026-09-25 robots: noindex

الوصف

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

الأذونات

wallpaper

مدى التوفّر

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

البيان

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

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

"STRETCH"

"CENTER"

"CENTER_CROPPED"

الطُرق

setWallpaper()

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

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

المعلمات

  • التفاصيل

    عنصر

    • البيانات

      ‫ArrayBuffer اختياري

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

    • filename

      سلسلة

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

    • التصميم

      WallpaperLayout

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

    • صورة مصغّرة

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

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

    • url

      string اختياري

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

  • callback

    function اختياري

    تظهر المَعلمة callback على النحو التالي: 

    (thumbnail?: ArrayBuffer) => void

    • صورة مصغّرة

      ‫ArrayBuffer اختياري

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

المرتجعات

  • Promise<ArrayBuffer | undefined>

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

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، وتحتاج المنصات الأخرى إلى استخدام عمليات الاستدعاء.