Skip to main content
تقوم عمليات التصدير بعرض كاريوكي مكتمل كملف فيديو. استخدم client.exports.create(...) كنقطة الدخول الرئيسية. اختر target: "local" عندما تريد أن يقوم الـ SDK بالعرض مباشرةً على الجهاز الحالي؛ وإلا فالتصدير السحابي هو الافتراضي.

client.exports.create(projectId, input, options?)

اختر هدف التصدير باستخدام target: "cloud" | "local".
استخدم السحابة عندما تريد تصديرًا مُدارًا وغير متزامن. واستخدم المحلي عندما تريد العرض مباشرةً على جهاز المستدعي.

الحقول الشائعة

استخدم fps: 60 لحركة أكثر سلاسة. تَطبّق عروض الأسعار السحابية مضاعِف أرصدة 1.5x عند 60 fps. تتوفر عمليات التصدير السحابية الشفافة عند 60 fps عندما تتوافق المدة والدقة المحددتان مع حدود السحابة.

مثال مع مستويات صوت الـ stem

مثال مع تجاوز الإعدادات

اطّلع على مرجع إعدادات العرض للشكل الكامل لـ settingsOverride.

client.exports.quote(projectId, input, options?)

قدِّر الأرصدة المطلوبة لعملية تصدير سحابية دون بدء التصدير.
تعمل عمليات التصدير المحلية على جهاز المستدعي ولا تستخدم أرصدة التصدير السحابي، لذا فإن quote(...) مخصص فقط لعمليات التصدير السحابية.

client.exports.list(projectId, input?, options?)

اعرض قائمة عمليات التصدير لمشروع ما، مع دعم الترقيم (pagination).
number
رقم الصفحة. القيمة الافتراضية 1 على الخادم.
number
حجم الصفحة. القيمة الافتراضية 100. الحد الأقصى 100.

client.exports.get(exportId, options?)

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

التصدير المحلي

استخدم onDependencyProgress إذا كنت تريد تحديثات أثناء تثبيت سلسلة أدوات العرض المحلية أو التحقق منها.

client.exports.prepareLocal(projectId, body, options?)

يُرجع الحمولة المُحضّرة اللازمة لعرض عملية تصدير محليًا. استخدم هذا عند التكامل مع @youka/remotion أو أي عارض محلي آخر. يقوم الخادم بإرجاع مدخلات الـ composition وروابط الأصول (asset URLs) ومعلمات العرض دون وضع عرض سحابي في الطابور.
لا يقوم client.exports.prepareLocal(...) ببدء عرض سحابي. لا يتم استهلاك أي حوسبة قابلة للفوترة من جهة Youka.

انتظار اكتمال عملية تصدير

عمليات التصدير السحابية غير متزامنة. استخدم client.exports.wait(...):

تنزيل النتيجة

تنتهي عمليات التصدير السحابية برابط url موقّع. استخدم المساعد المضمّن لتمرير الملف (stream) إلى القرص. يمكن أن يكون output إما مجلدًا أو مسار ملف كاملًا، وfilename اختياري:

ما التالي

  • Tasks — مقابض العمليات والاستطلاع (polling) المتقدم للمهام
  • Presets — إعدادات عرض قابلة لإعادة الاستخدام
  • Project settings — تعديل إعدادات المشروع النشطة بشكل جزئي