chrome.wallpaper

الوصف

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

الأذونات

wallpaper

يجب تضمين الإذن "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

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

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

Enum

"STRETCH"

"CENTER"

"CENTER_CROPPED"

الطُرق

setWallpaper()

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

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

المعلمات

  • التفاصيل

    عنصر

    • البيانات

      ArrayBuffer اختياري

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

    • filename

      سلسلة

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

    • التصميم

      WallpaperLayout

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

    • صورة مصغّرة

      boolean اختياري

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

    • url

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

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

المرتجعات

  • Promise<ArrayBuffer | undefined>

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