تحديث تخصيص مشغّل المشروع

تدعم هذه العملية مصادقة ملف ارتباط جلسة لوحة التحكم. استدعها من شيفرة خادم موثوقة فقط، ولا تنشئ المتصفحات ملف الجلسة أو تكشفه.

تحديث جزئي: أرسل الحقول المتغيّرة فقط، ويُحدَّث controls لكل مفتاح. يُخزَّن ويُعاد الكائن الفعلي كاملًا بعد دمج القيم الافتراضية وتطبيع playbackSpeeds لتتضمن 1.0. وتعرض مخالفات CSS في error.details.violations.

حد المعدّل: 60 طلبًا لكل 60 ثانية لكل جلسة.

رموز الخطأ: unauthorized (401), not_found (404), invalid_player_settings (400), invalid_custom_css (400 — the response error.details.violations lists the rejected rules).

المصادقة

• sessionCookie — ملف ارتباط جلسة لوحة التحكم الذي يضبطه POST /v1/auth/login. تتطلب مسارات الفيديو والتشغيل أيضًا معامل projectId عند استخدام الجلسة.

المعاملات

جسم الطلب

إلزامي

نوع المحتوى: application/json

المخطّط: PlayerSettingsPatch

{
  "uiLanguage": "en",
  "primaryColor": "#14e6b3",
  "controls": {
    "pip": true
  },
  "playbackSpeeds": [
    0.5,
    1,
    1.5,
    2,
    3
  ]
}

الاستجابات

مثال على الطلب

{
  "uiLanguage": "en",
  "primaryColor": "#14e6b3",
  "controls": {
    "pip": true
  },
  "playbackSpeeds": [
    0.5,
    1,
    1.5,
    2,
    3
  ]
}