الإعداد المسبق هو إعداد عرض قابل لإعادة الاستخدام — الخلفية، ونمط الترجمة الفرعية، والتخطيط، وإعدادات مرئية أخرى — يمكنك تطبيقه على أي مشروع أو تصدير. تُعد الإعدادات المسبقة مثالية عندما تريد مظهراً متسقاً عبر العديد من المقاطع.
اطّلع على Render settings reference للحصول على الشكل الكامل لـ
preset وكل خيار مدعوم بقيم تعداد (enum).
preset schemaإرجاع مخطط JSON Schema لإعدادات الإعدادات المسبقة. استخدم هذا لاكتشاف الحقول الصالحة قبل إنشاء إعداد مسبق أو تحديثه.
youka preset schema --json
يجب على الوكلاء استدعاء preset schema قبل تعديل الإعدادات المسبقة لكي يعرفوا
أسماء الحقول الدقيقة وأنواع القيم.
preset listسرد جميع الإعدادات المسبقة المملوكة للحساب المُصادَق عليه.
preset showجلب إعداد مسبق واحد حسب المعرّف.
youka preset show < presetI d > --json
preset createإنشاء إعداد مسبق جديد.
youka preset create [options]
Options الخيار الوصف --name <name>اسم الإعداد المسبق --defaultتعيين الإعداد المسبق الجديد كافتراضي --body <file|->قراءة كامل نص الطلب من ملف أو من stdin
يجب أن يحتوي نص الطلب على كائن preset بالكامل. للحمولات الكبيرة،
يُفضَّل استخدام --body بدلاً من JSON مضمّن داخل السطر.
Examples from-file
make-default
from-stdin
youka preset create \ --name "Neon Night" \ --body ./neon-preset.json \ --json
تتغلب أعلام CLI على الحقول المطابقة القادمة من --body.
preset updateتحديث إعداد مسبق موجود.
youka preset update < presetI d > [options]
الخيار الوصف --name <name>الاسم الجديد --body <file|->كامل نص الطلب من ملف أو من stdin
مثال:
youka preset update $PRESET_ID \ --name "Neon Night v2" \ --body ./neon-v2.json \ --json
preset deleteحذف إعداد مسبق حسب المعرّف.
youka preset delete < presetI d > --json
حذف إعداد مسبق لا يحذف المشاريع أو عمليات التصدير التي سبق
عرضها باستخدامه. ستفشل عمليات التصدير المستقبلية التي تشير إلى الإعداد المسبق المحذوف.
preset defaultالحصول على الإعداد المسبق الافتراضي أو تعيينه.
youka preset default --json youka preset default < presetI d > --json
من دون أي وسيط، يُرجع الأمر الإعداد المسبق الافتراضي الحالي أو null. ومع معرّف إعداد مسبق، يقوم بتعيين ذلك الإعداد المسبق كافتراضي.
تطبيق إعداد مسبق طبّق إعداداً مسبقاً على مشروع أو تصدير باستخدام --preset:
on-create
on-settings-update
on-export
youka project create ./song.mp3 --preset $PRESET_ID --wait
ما التالي
Render settings reference - جميع حقول الإعدادات المسبقة المشتركةProjects - تطبيق الإعدادات المسبقة على إعدادات المشروعExports - تطبيق الإعدادات المسبقة وقت العرضMedia - وسائط قابلة لإعادة الاستخدام تشير إليها الإعدادات المسبقة 