client.exports.create(...) كنقطة الدخول الرئيسية. اختر target: "local" عندما تريد أن يقوم الـ SDK بالعرض مباشرةً على الجهاز الحالي؛ وإلا فالتصدير السحابي هو الافتراضي.
client.exports.create(projectId, input, options?)
اختر هدف التصدير باستخدام target: "cloud" | "local".
الحقول الشائعة
استخدم
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 للاطلاع على مثال التصدير الكامل.