chrome.wallpaper

refresh date: 2026-09-25 robots: noindex

الوصف

استخدِم واجهة برمجة التطبيقات 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

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

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

تعداد

"STRETCH"

"CENTER"

"CENTER_CROPPED"

الطُرق

setWallpaper()

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

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

المعلمات

  • التفاصيل

    عنصر

    • البيانات

      ‫ArrayBuffer اختياري

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

    • filename

      سلسلة

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

    • التصميم

      WallpaperLayout

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

    • صورة مصغّرة

      boolean اختياري

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

    • url

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

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

  • callback

    الدالة اختيارية

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

    (thumbnail?: ArrayBuffer) => void

    • صورة مصغّرة

      ‫ArrayBuffer اختياري

      الصورة المصغّرة للخلفية المرمّزة بتنسيق jpeg يتم إنشاؤها عن طريق تغيير حجم الخلفية إلى 128x60.

المرتجعات

  • Promise<ArrayBuffer | undefined>

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

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