Skip to main content
كل عملية غير متزامنة في Youka تعمل في النهاية كمهمة، لكن واجهة الـ SDK الأساسية تُرجع الآن مقابض عمليات بدلًا من معرّفات مهام خام. ينبغي لمعظم المستخدمين استعمال client.projects.wait(...) أو client.exports.wait(...) وعدم اللجوء إلى client.tasks.* إلا عند الحاجة إلى فحص منخفض المستوى للمهمة.

client.tasks.get(taskId, options?)

اجلب الحالة الحالية لمهمة عبر المعرّف.

حالات المهام

client.tasks.wait(taskId, options?)

استطلع حالة المهمة حتى تصل إلى حالة نهائية. يُرجع المهمة النهائية عند النجاح، ويطلق YoukaTaskError عند الفشل.

الخيارات

number
عدد الملّي ثواني بين عمليات الاستطلاع. القيمة الافتراضية 2000.
AbortSignal
إلغاء الانتظار. يتم إلغاء الطلب الجاري وأي تأخير مُعلّق فورًا.

الأخطاء

تُطلق client.tasks.wait(...) خطأ YoukaTaskError عندما تنتهي المهمة بحالة failed أو cancelled أو timed-out:

client.projects.wait(operation, options?)

انتظر حتى تنتهي عملية ضمن نطاق المشروع، ثم أعد جلب المشروع. يُرجع مقبض العملية، والمهمة النهائية، والمشروع المحدّث.
ProjectOperation
required
عادةً ما يكون ناتج client.projects.create(...), client.projects.separateStems(...), أو client.projects.syncLyrics(...).

client.exports.wait(operationOrId, options?)

انتظر حتى يصل تصدير سحابي إلى حالة نهائية. مرّر إمّا ExportOperation المُرجَع من client.exports.create(...) أو سلسلة exportId.

الإلغاء

مرّر AbortSignal لإلغاء انتظار طويل التشغيل:
تُلغِي الإشارة نفسها أيضًا طلب الاستطلاع الأساسي للمهمة أو التصدير.

ما التالي