استيراد مقاطع الفيديو

يمكن لـ TubePress ملء مكتبتك بعدة طرق — من إضافة مقطع واحد يدويًا إلى جلب مئات الآلاف من مقاطع الفيديو الجاهزة من السحابة. تغطي هذه الصفحة أداة الاستيراد المدمجة وتوضح أين تجد كل مسار آخر.

بغض النظر عن الطريقة التي تختارها، النتيجة واحدة: مقاطع فيديو عادية يمكنك تحريرها وتنظيمها والإشراف عليها ونشرها مثل أي محتوى آخر. اختر الطريقة التي تناسب حجم المحتوى لديك، وما إذا كنت تريد تحميلًا لمرة واحدة أو شيئًا يجدد نفسه باستمرار.

طرق إضافة المحتوى إلى TubePress

لا توجد طريقة واحدة "صحيحة" لإضافة مقاطع الفيديو — كل طريقة تناسب حجمًا وسير عمل مختلفين. استخدم الجدول أدناه للاختيار، ثم اتبع الرابط للتفاصيل.

استيراد مقطع فيديو واحد

لا تحتوي TubePress على أداة استيراد منفصلة لـ "مقطع واحد" — لإضافة مقطع فيديو واحد، استخدم شاشة الفيديوهات في /admin/videos واختر إضافة فيديو. هناك طريقتان لتقديم الوسائط:

• رفع يدوي — قم برفع ملف فيديو تستضيفه بنفسك.
• استيراد بعنوان URL واحد — الصق كود تضمين <iframe> أو عنوان URL مباشر لفيديو لتضمين مقطع مستضاف في مكان آخر.

أدخل العنوان والصورة المصغرة، وأضف أي تصنيفات أو وسوم أو فنانين، ثم احفظ كمسودة أو انشر مباشرة. لا تستهلك أي من الطريقتين رصيدًا.

الاستيراد المجمّع

يوجد الاستيراد المجمّع في تبويب رفع الملف في /admin/import. يأخذ ملف CSV أو JSON واحدًا — وليس قائمة عناوين URL ملصوقة — ويحوّل كل صف أو كائن إلى مقطع فيديو.

• يجب أن يحتوي CSV على صف رأسي ويستخدم الفواصل كفواصل بين الحقول.
• يجب أن يكون JSON مصفوفة من الكائنات.

اسحب الملف إلى منطقة الرفع (أو انقر للاستعراض) وستقرأ TubePress الأعمدة وتعرض معاينة. أدنى صيغة لملف CSV تبدو كما يلي:

title,embed_code,thumbnail,duration,tags
My clip,https://ex.com/v/123.mp4,https://ex.com/t.jpg,612,"solo,hd"

بعد ذلك، عيّن أعمدتك إلى حقول TubePress بسحبها إلى مكانها. تشمل الحقول التي يتعرف عليها المستورد:

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

كيف تعمل قائمة انتظار الاستيراد

لأي شيء يتجاوز ملفًا صغيرًا، اختر البدء في الخلفية. تنشئ TubePress مهمة وتسلّمها إلى معالج الاستيراد، الذي يعمل على صفوفك حتى بعد إغلاق التبويب. لا تحتاج إلى crontab للنظام — فهو يعمل على pseudo-cron المدمج.

تم تصميم المعالج ليكون آمنًا وقويًا:

• مجزّأ. تُستورد الصفوف بضعة في كل مرة حتى لا يتعطل عامل الويب؛ تتحكم سرعة الاستيراد القابلة للضبط في عدد الصفوف لكل جزء.
• غير متزامن. يلتقط pseudo-cron المهمة عندما يستقبل الموقع حركة مرور، وتدفع صفحة الاستيراد العملية للأمام طالما كانت مفتوحة.
• تعافٍ ذاتي. تُعاد جدولة المهمة المتوقفة — كإعادة تشغيل الخادم في منتصف العملية مثلًا — تلقائيًا بعد نحو خمس دقائق وتستأنف من حيث توقفت.
• إزالة التكرار. يتم تخطي الصفوف التي تحمل video_id معروفًا أو تحديثها بدلًا من تكرارها.
• متسامح. يتم تسجيل الصف الخاطئ (يُؤخذ عينة من أول بضعة أخطاء لكل جزء) وتستمر المهمة.

مراقبة تقدم الاستيراد

افتح /admin/import وراقب قائمة انتظار الاستيراد. تعرض كل مهمة نشطة أعدادًا مباشرة — المستوردة والمتخطاة والأخطاء والمعالجة من الإجمالي — تُحدَّث كل بضع ثوانٍ.

من هنا يمكنك إيقاف مؤقت أو استئناف أو إلغاء أو حذف مهمة. تظل المهام من آخر 24 ساعة مدرجة حتى تتمكن من مراجعة ما حدث، بما في ذلك رسائل الخطأ المأخوذة كعينات لأي صفوف فشلت.

نصائح وقيود

• يُقبل فقط ملفات .csv و.json؛ وترفض التنسيقات الأخرى فورًا.
• الحد الأدنى العملي لكل صف هو عنوان بالإضافة إلى كود تضمين وصورة مصغرة.
• حجم الرفع محدود بإعدادات upload_max_filesize وpost_max_size في خادمك. قسّم الملفات الكبيرة جدًا، أو اعتمد على مهمة خلفية.
• عيّن video_id ثابتًا حتى يُحدَّث الملف عند إعادة تشغيله بدلًا من التكرار.
• فعّل تنزيل الصور المصغرة لاستضافة الصور بنفسك بدلًا من الربط المباشر بالمصدر.
• تستهلك إعادة الكتابة والترجمة بالذكاء الاصطناعي رصيدًا وتحتاج إلى حساب tubepress.io مرتبط؛ إذا كان رصيدك منخفضًا جدًا، تتوقف المهمة برسالة واضحة.

الخطوات التالية