تصحيح أخطاء Filter Complex في FFmpeg
في هذا الدرس، ستتعلم كيفية تصحيح أحد التحديات الأكثر شيوعًا وإرباكًا التي يواجهها مستخدمو FFmpeg: الأخطاء في رسوميات `filter_complex-`. عندما ترى رسائل مثل Cannot find a matching stream for unlabeled input pad (تعذّر العثور على تدفق مطابق لحقل إدخال غير مسمى) أو Invalid data found when processing input (تم العثور على بيانات غير صالحة عند معالجة الإدخال)، فهذا يعني غالبًا أن هناك شيئًا ما في سلسلة المرشحات لديك غير متصل أو مشار إليه بشكل خاطئ. توفر هذه المقالة منهجًا واضحًا خطوة بخطوة لتشخيص هذه المشكلات وإصلاحها — لتحويل الإحباط إلى إتقان.

1. لماذا تفشل رسوميات ترشيح FFmpeg؟

يُعد نظام `filter_complex-` في FFmpeg قويًا للغاية — يمكنه تراكب مقاطع فيديو متعددة، واقتصاصها، وتغبيشها، واقتطاعها، وحتى دمجها في وقت واحد. لكن هذه المرونة تأتي مع التعقيد. تحدث الأخطاء عندما:

• لا يتم تسمية تدفقات الإدخال (الفيديو/الصوت) بشكل صحيح.
• لا يتم توصيل مخرجات المرشحات بالمرحلة التالية.
• تشير مرشحات التراكب أو التعيين إلى تدفقات غير موجودة.
• ملفات الإدخال مفقودة، أو تالفة، أو مرتبة بشكل غير صحيح.

يُعد فهم هذه الأساسيات مفتاحًا لتصحيح الأخطاء مثل مهندس فيديو محترف.

2. خطأ شائع: "Cannot find a matching stream for unlabeled input pad"

يعد هذا أحد أكثر أخطاء FFmpeg شيوعًا وإرباكًا. وهو يعني عادةً أن أحد المرشحات لديك — على سبيل المثال، مرشح التراكب (overlay) أو الدمج (concat) — يتوقع تدفق إدخال مُسَمَّى، ولكن لم يتم توفيره.

مثال على الخطأ:

Cannot find a matching stream for unlabeled input pad 1 on filter Parsed_overlay_10

سبب حدوثه:

• يتطلب مرشح التراكب مدخلي فيديو (الأساس والتراكب)، ولكن تم توصيل واحد فقط بشكل صحيح.
• لم يتم تسمية أحد مدخلات الفيديو (مثل [0:v] أو [1:v]).
• نسيت تضمين ملف مصدر التراكب أو الإشارة إليه في -filter_complex.

كيفية إصلاحه:

1. تحقق من جميع مصادر الإدخال في الأمر الخاص بك. مثال: -i background.mp4 -i logo.png.
2. قم بتعيينها أو الإشارة إليها بشكل صريح في رسم المرشح الخاص بك: [0:v][1:v].
3. تأكد من أن مرشح التراكب يربط كلا التدفقين بشكل صحيح:

   ffmpeg -i background.mp4 -i logo.png -filter_complex "[0:v][1:v] overlay=10:10" output.mp4

3. خطأ: "Invalid data found when processing input"

غالبًا ما تظهر هذه الرسالة عندما لا يستطيع FFmpeg فتح ملف إدخال أو تفسيره — إما بسبب ملف مفقود، أو مسار غير صحيح، أو تلف في الملف.

تشمل الأسباب الشائعة ما يلي:

• استخدام ملف غير موجود في الدليل (مثل before_segment.mp4).
• تنسيق غير صحيح لملف filelist.txt عند دمج مقاطع الفيديو.
• ملفات MP4 غير مكتملة أو تالفة (تفتقر إلى جزء moov atom).

كيفية إصلاحه:

• تحقق من مساراتك. استخدم المسارات المطلقة إذا لزم الأمر، على سبيل المثال: /home/user/videos/before_segment.mp4.
• لعمليات الدمج (concat)، تأكد من أن قائمة الملفات الخاصة بك صحيحة:

  file 'part1.mp4'
  file 'part2.mp4'

• قم بتشغيل ffprobe للتحقق من سلامة الملف:

  ffprobe before_segment.mp4

  إذا ذكر "moov atom not found"، قم بإعادة تصدير الفيديو أو معالجته.

4. تصحيح الأخطاء خطوة بخطوة باستخدام رسوميات مرشحات صغيرة

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

مثال لسير العمل:

1. اختبار مرشح واحد:

   ffmpeg -i input.mp4 -vf "boxblur" test_blur.mp4

2. ثم أضف شرط التوقيت:

   ffmpeg -i input.mp4 -vf "boxblur=enable='between(t,10,20)'" test_timed_blur.mp4

3. بعد ذلك، أضف تراكبًا (overlay):

   ffmpeg -i input.mp4 -i logo.png -filter_complex "[0:v][1:v] overlay=10:10:enable='between(t,5,15)'" test_overlay.mp4

من خلال اختبار كل مكون على حدة، يمكنك تحديد مكان حدوث الخطأ بالضبط قبل إنشاء أمر إنتاج كامل.

5. تسمية كل شيء بوضوح

عند بناء رسوميات مرشحات معقدة، تعد تسمية التدفقات أمرًا ضروريًا. فالتدفقات غير المسماة أو الغامضة هي السبب الرئيسي لفشل أوامر FFmpeg.

مثال لسلسلة مُسَمَّاة:

[0:v]scale=1280:720[scaled];
[1:v]format=rgba[logo];
[scaled][logo]overlay=10:10:enable='between(t,3,8)'[outv]

يخبر نظام التسمية هذا FFmpeg بكيفية تدفق كل تدفق عبر الرسم البياني — مما يجعل أوامرك أسهل في تصحيح الأخطاء والصيانة.

6. مثال واقعي: تصحيح خطأ تراكب معقد

لنفترض أنك تقوم بتشغيل الأمر التالي وتتلقى خطأً:

ffmpeg -i main.mp4 -filter_complex "[0:v][1:v] overlay=10:10" output.mp4

ولكنك نسيت تضمين إدخال ثانٍ (مثل logo.png). يطرح FFmpeg خطأً مفاده أنه لا يمكنه العثور على حقل الإدخال. الحل هو ببساطة إضافة الملف المفقود:

ffmpeg -i main.mp4 -i logo.png -filter_complex "[0:v][1:v] overlay=10:10" output.mp4

تحقق دائمًا من أن عدد ملفات الإدخال يتطابق مع عدد مراجع الإدخال في سلسلة المرشحات الخاصة بك.

7. نصائح احترافية لاستكشاف أخطاء رسوميات الترشيح وإصلاحها

• استخدم السجلات: أضف -report لإنشاء سجل تفصيلي لتصحيح الأخطاء.
• تصوّر تدفق المرشح: يمكنك تصدير الرسم البياني باستخدام -graph_file (في بعض إصدارات FFmpeg).
• استخدم التسمية التدريجية: ابدأ بـ [in1]، [in2]، [out1] للوضوح.
• اختبار سلاسل المرشحات بشكل تدريجي: البناء من بسيط ← متوسط ← معقد.

8. حالات الاستخدام العملية والتجارية

تصحيح أخطاء رسوميات المرشحات ليس مجرد مهارة تقنية — إنه مُمكّن للأعمال التجارية. يستخدم المحترفون FFmpeg للأتمتة في هذه المجالات:

• **شركات الإعلام:** وضع علامة مائية تلقائيًا على آلاف مقاطع الفيديو دون تحرير يدوي.
• **منصات التعليم الإلكتروني:** تراكب نصوص ديناميكية، وعناوين فصول، ورسوم متحركة للاختبارات.
• **وكالات تسويق الفيديو:** إضافة مقدمات ونهايات تحمل علامات تجارية برمجياً.

إن معرفة كيفية إصلاح أخطاء مرشحات FFmpeg تضمن سير خطوط الأتمتة الخاصة بك بسلاسة دون توقف.

9. نصيحة لتحسين محركات البحث والبحث (SEO and Search Optimization Tip)

إذا كنت تكتب محتوى تقنيًا أو وثائق، فقم بتضمين كلمات رئيسية مثل "إصلاح خطأ FFmpeg filter_complex"، و "FFmpeg تعذّر العثور على تدفق مطابق"، و "تصحيح أخطاء FFmpeg overlay". هذه عبارات يتم البحث عنها بشكل كبير وتساعد المطورين الآخرين في العثور على الحلول بسرعة.

الخلاصة

يدور تصحيح أخطاء FFmpeg filter_complex حول البنية والصبر والوضوح. من خلال تسمية التدفقات، والاختبار بشكل تدريجي، وفهم كيفية اتصال كل مرشح، يمكنك حل أي رسالة خطأ تقريبًا يطرحها عليك FFmpeg. بمجرد إتقانها، تطلق مهارات تصحيح الأخطاء هذه العنان للأتمتة والإبداع اللامحدود في معالجة الفيديو.

التالي في هذه الدورة: "ربط ودمج أجزاء الفيديو" — تعلّم كيفية ضم مقاطع فيديو متعددة بسلاسة في ملف واحد جاهز للإنتاج.