الوسائط

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

أنواع الوسائط

النوع	الوصف
`video`	فيديو خلفية متكرر.
`image`	صورة خلفية ثابتة.
`logo`	تراكب شعار.
`intro-video`	يُشغَّل قبل بدء الكاراوكي.
`outro-video`	يُشغَّل بعد انتهاء الكاراوكي.

نقاط النهاية

الطريقة	المسار	الغرض
`GET`	`/media`	سرد الوسائط للحساب المُصادَق عليه.
`POST`	`/media`	تسجيل ملف مرفوع مسبقًا كوسائط قابلة لإعادة الاستخدام.
`GET`	`/media/{mediaId}`	جلب عنصر وسائط واحد.
`DELETE`	`/media/{mediaId}`	حذف عنصر وسائط.

مخططات الطلب والاستجابة الكاملة موجودة في مرجع API.

سير عمل الرفع

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

إنشاء هدف رفع

curl -X POST https://api.youka.io/ar/api/v1/uploads \
  -H "Authorization: Bearer yk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "filename": "background.mp4",
    "contentType": "video/mp4",
    "contentLength": 8421120
  }'

تتضمن الاستجابة inputFileId وuploadUrl.

PUT بايتات الملف

curl -X PUT "$UPLOAD_URL" \
  -H "Content-Type: video/mp4" \
  --data-binary "@./background.mp4"

تسجيل عنصر الوسائط

curl -X POST https://api.youka.io/ar/api/v1/media \
  -H "Authorization: Bearer yk_..." \
  -H "Idempotency-Key: bg-loop-v1" \
  -H "Content-Type: application/json" \
  -d '{
    "inputFileId": "file_abc123",
    "type": "video"
  }'

تتضمن الاستجابة mediaId الجديد وurl الخاص بالوسائط. استخدم url داخل الإعدادات المسبقة أو إعدادات المشروع.

POST /media لا يقبل رفع ملفات خام. يتوقع inputFileId من استدعاء سابق لـ POST /uploads + PUT.

سرد الوسائط

curl https://api.youka.io/ar/api/v1/media \
  -H "Authorization: Bearer yk_..."

يعيد مصفوفة تضم كل عنصر وسائط قابل لإعادة الاستخدام ضمن الحساب المُصادَق عليه.

تطبيق خلفية

أشر إلى الوسائط المرفوعة من إعداد مسبق أو مباشرةً من إعدادات المشروع:

curl -X PATCH https://api.youka.io/ar/api/v1/projects/prj_abc/settings \
  -H "Authorization: Bearer yk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "settings": {
      "style": {
        "background": {
          "type": "image",
          "url": "https://cdn.youka.io/backgrounds/bg_abc123.jpg",
          "objectFit": "cover"
        }
      }
    }
  }'

حذف الوسائط

curl -X DELETE https://api.youka.io/ar/api/v1/media/bg_abc123 \
  -H "Authorization: Bearer yk_..." \
  -H "Idempotency-Key: delete-bg_abc123"

حذف الوسائط لا يؤثر على المشاريع أو عمليات التصدير التي تم تصييرها سابقًا باستخدامها. عمليات التصيير المستقبلية التي تشير إلى الوسائط المحذوفة ستعود إلى الخلفية الافتراضية.

ما التالي

مرجع إعدادات التصيير — جميع مسارات الحقول المشتركة وقيم enum
الإعدادات المسبقة — تجميع الوسائط مع إعدادات التصيير الأخرى
إعدادات المشروع — تطبيق الخلفيات على مشروع
وسائط SDK — نفس التدفق في TypeScript

Overview

How To

Customization

Audio

Settings

Exporting

Account

أنواع الوسائط

نقاط النهاية

سير عمل الرفع

سرد الوسائط

تطبيق خلفية

حذف الوسائط

ما التالي

​أنواع الوسائط

​نقاط النهاية

​سير عمل الرفع

​سرد الوسائط

​تطبيق خلفية

​حذف الوسائط

​ما التالي

أنواع الوسائط

نقاط النهاية

سير عمل الرفع

سرد الوسائط

تطبيق خلفية

حذف الوسائط

ما التالي