chrome.wallpaper

الوصف

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

الأذونات

wallpaper

مدى التوفّر

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

البيان

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

{
  "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 والإصدارات الأحدث

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

Enum

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

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

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