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

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

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

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

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

مثال مع stem volumes

مثال مع settings override

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

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

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

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

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

client.exports.get(exportId, options?)

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

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

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

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

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

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

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

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

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

ما التالي

  • Tasks — معالجات العمليات واستطلاع المهام المتقدم
  • Presets — إعدادات عرض قابلة لإعادة الاستخدام
  • Project settings — رقّع إعدادات المشروع النشطة

لقطات الإصدار والتوقيت

اعرض الإصدارات باستخدام client.projects.versions.list(projectId). مرّر versionId إلى exports.create أو exports.quote أو exports.prepareLocal. يعود التنسيق (Styling) لذلك الإصدار، بينما تعود المحاذاة (alignment) المحددة للمشروع. تتضمن معالجات عمليات التصدير السحابي والحمولات المحلية versionId وalignmentId وalignmentRevision. تُعرّف هذه الحقول نفس لقطة التوقيت المستخدمة لبناء الـ composition. قد تلاحظ عملية إعداد أو تصدير لاحقة تعديلات أحدث. احفظ الحمولة المُجهزة إذا كان يجب على عارض خارجي استخدام تلك اللقطة نفسها بالضبط، وقم بتحديث روابط الوسائط الموقعة المنتهية الصلاحية. لإسكات كل stem، ابنِ stemVolumes من معرّفات stem الخاصة بالمشروع مع تعيين كل قيمة إلى صفر. يستخدم التصدير المحلي الشفاف ProRes 4444 ضمن حاوية MOV. قد يحتوي إخراج صامت على مسار صوتي رغم ذلك. راجع Automate lyric videos للاطلاع على مثال التصدير الكامل.