Record Video

هذه دالة بلوك تحفظ إطارات الصورة الواردة في ملف فيديو. يمكنك بدء وإيقاف التسجيل باستخدام مشغل منطقي (Boolean) أو استخدام مفتاح المسافة المدمج. تتوفر عدة أوضاع جودة، بما في ذلك خيار ضغط عالي يستخدم ffmpeg إذا كان مثبتًا.

📥 المدخلات

Frame الإطارات (الفريمات) الواردة التي سيتم تسجيلها.

Record مفتاح منطقي لبدء/إيقاف التسجيل (يُستخدم حسب وضع التشغيل المختار).

Folder Path المجلد الذي سيتم حفظ ملفات الفيديو فيه.

File Name (no extension) اسم ملف اختياري كأساس؛ إذا تُرك فارغًا، سيُستخدم طابع زمني.

📤 المخرجات

هذا البلوك لا يوفر مخرجات.

🕹️ عناصر التحكم

Video Quality اختَر من أوضاع الجودة:

• Compressed ملفات أصغر، أداء سريع.

• High Quality ضغط أقل وجودة بصرية أفضل.

• High-Compress(requires ffmpeg) أفضل ضغط ولكن يتطلب توفر ffmpeg على النظام.

Trigger Mode اختر كيف يبدأ/يتوقف التسجيل:

• Spacebar اضغط مفتاح المسافة لتشغيل/إيقاف (يتطلب توافر التقاط لوحة المفاتيح على نظام التشغيل).

• Continuous قدّم TRUE لبدء و FALSE للإيقاف.

• Once إشارة TRUE متصاعدة تبدأ التسجيل، وإشارة TRUE لاحقة توقف وتحفظ.

Recording مؤشر بصري (LED) يوضح ما إذا كان التسجيل مفعلًا.

🎯 الميزات الرئيسية

• بدء/إيقاف التسجيل باستخدام ثلاثة أوضاع تريجر (Spacebar، Continuous، Once).

• أوضاع جودة متعددة بما فيها خيار ضغط عالي مبني على ffmpeg.

• يختار تلقائيًا برامج الترميز (codecs) وحاويات الفيديو المتاحة للتماشي مع الأنظمة المختلفة.

• يمنع فتح ملف الفيديو أثناء التسجيل لتفادي تعارضات الملف.

• تحويل خلفي (background conversion) لوضع High-Compress بحيث لا يعيق الضغط التقاط الإطارات في الزمن الحقيقي (يتطلب ffmpeg).

📝 كيفية الاستخدام

1. وصل مصدر الإطارات إلى Frame (مثلاً من Camera USB، Camera IP (ONVIF)، أو Stream Reader).

2. حدّد Folder Path لحفظ ملفات الفيديو.

3. اختياريًا ضع File Name (no extension) أو اتركه فارغًا لاستخدام طابع زمني.

4. اختر Video Quality المرغوب. إذا أردت أصغر ملفات مع أعلى ضغط، اختر High-Compress(requires ffmpeg) وتأكد من تثبيت ffmpeg.

5. اختر Trigger Mode:

   • للتحكم السريع من لوحة المفاتيح استخدم Spacebar (يعمل إن سمح نظام التشغيل).

   • للتحكم برمجيًا استخدم Continuous أو Once وأرسل قيم منطقية إلى Record.

6. ابدأ التسجيل وفق وضع التشغيل المختار. سيضيء مؤشر Recording أثناء الالتقاط.

7. أوقف التسجيل وانتظر البلوك لينهي حفظ الملف. إذا اخترت وضع High-Compress وسيكون ffmpeg متاحًا، قد يعمل الضغط النهائي في الخلفية.

📊 السلوك أثناء التشغيل

• أثناء التسجيل النشط، تُضاف الإطارات الواردة إلى ملف الفيديو المفتوح.

• عند الإيقاف يُغلَق الملف. إذا تم اختيار وضع الضغط العالي ووجد ffmpeg، قد يُشغّل تحويل خلفي لتجهيز ملف مضغوط أصغر.

• إن لم يكن تريجر Spacebar متاحًا (شائع في بعض توزيعات Linux بدون صلاحيات مرتفعة)، سيظهر تحذير ويمكنك استخدام أوضاع Continuous أو Once.

💡 نصائح وحيل

• لتسجيل من كاميرا محلية، وصل Camera USB أو Camera USB External إلى Frame.

• للكاميرات الشبكية، استخدم Camera IP (ONVIF) أو Stream Reader كمصدر للحصول على جلب إطارات سلس في الخلفية.

• معاينة الإطارات مباشرة بإرسال نفس المصدر إلى بلوك Show Image إلى جانب هذا البلوك.

• احفظ إطارات فردية للتفحص بالتوازي باستخدام Image Logger أو Image Write أثناء تسجيل الفيديو.

• شغّل التسجيل تلقائيًا عند ظهور حدث مهم بربط بلوكات الكشف مثل Object Detection أو Mask Detection إلى مسار منطقي يغذي Record.

• استخدم Keyboard/Barcode Reader إذا احتجت مشغلات لوحة مفاتيح أو مدخلات خارجية معقدة توجه إلى Record.

• إذا كنت تريد حجم تخزين أصغر مع جودة مقبولة، اختر High-Compress(requires ffmpeg) وتأكد من وضع ffmpeg على الـ system PATH.

🛠️ استكشاف الأخطاء وإصلاحها

• تريجر Spacebar لا يعمل على Linux: شغّل Studio بصلاحيات مرتفعة أو استخدم أوضاع Continuous/Once.

• الضغط غير متاح: تأكد من تثبيت ffmpeg والوصول إليه عبر system PATH لتمكين وضع High-Compress. إذا كان ffmpeg مفقودًا، سيتراجع البلوك إلى وضع عدم ffmpeg وسيعرض تحذيرًا.

• الملف قيد الاستخدام أثناء التسجيل: لا يمكن فتح ملف الفيديو بواسطة تطبيقات أخرى أثناء التسجيل. انتظر حتى ينتهي التسجيل.

• لم يتم حفظ إطارات: تحقق أن المصدر الموصول إلى Frame يزود بصور صالحة (المعاينة عبر Show Image مفيدة).