Skip to main content
الإعداد المسبق هو تهيئة عرض قابلة لإعادة الاستخدام — الخلفية، نمط الترجمة، التخطيط — يمكنك تطبيقها على أي مشروع أو تصدير. استخدم الإعدادات المسبقة عندما يكون لديك مظهر متسق عبر العديد من المقاطع. اطّلع على مرجع إعدادات العرض للاطّلاع على الشكل الكامل لـ preset وكل خيار مدعوم بقيم enum.

متى تستخدم إعدادًا مسبقًا

استخدم إعدادًا مسبقًا عندما…

تريد المظهر نفسه عبر العديد من المشاريع وتحتاج إلى تحديثه في مكان واحد.

استخدم إعدادات المشروع عندما…

تحتاج إلى تجاوزات محلية على مستوى المشروع لا تستحق المشاركة.

نقاط النهاية

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

إنشاء إعداد مسبق

تتضمن الاستجابة presetId الجديد. خزّنه وارجع إليه من المشاريع أو عمليات التصدير.
اقترن بكل POST مفتاح idempotency. إعادة استخدام المفتاح نفسه مع الحمولة نفسها تُرجع الإعداد المسبق الأصلي بدلًا من إنشاء نسخة مكررة.

اكتشاف حقول الإعداد المسبق الصالحة

يتم التحقق من الإعدادات المسبقة على جانب الخادم مقابل KaraokePresetSchema. يقوم SDK بتصدير هذا المخطط بحيث يمكنك تحويله إلى JSON Schema أثناء التشغيل:
من خلال CLI:
ينبغي لمؤلفي الوكلاء استدعاء هذا قبل تعديل الإعدادات المسبقة حتى يعرف النموذج كل حقل صالح ونوع كل قيمة. مرجع سهل القراءة:

تحديث إعداد مسبق

مرّر أي جزء من name وpreset. الحقول التي لا تضمّنها ستبقى دون تغيير.

تعيين الإعداد المسبق الافتراضي

يمتلك كل حساب إعدادًا مسبقًا افتراضيًا واحدًا كحد أقصى، ويتم تطبيقه تلقائيًا على المشاريع الجديدة.
يؤدي تعيين افتراضي جديد إلى إلغاء تعيين الافتراضي السابق تلقائيًا.

تطبيق إعداد مسبق

ارجع إلى إعداد مسبق في ثلاثة أماكن: مثال عند التصدير:

حذف إعداد مسبق

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

ما التالي