🤖AI-generated documentation✓ curatedAI Generated

This page was drafted by an AI assistant and may contain inaccuracies. This content has been reviewed by a human curator.

About content generation types

🤖

AI Generated — Page drafted entirely by AI from codebase or prompt instructions.
(e.g., docs generated from codebase analysis)

← this page

✋→🤖

AI Transformatted — Human provided raw material; AI restructured it into a different format.
(e.g., livestream → blog post, meeting notes → docs)

✋

Human Generated — Page written entirely by a human author.
(e.g., hand-written tutorial)

More info about content generation types ↗

دليل المبتدئين

هالدليل بيوسّع على البداية السريعة بتفاصيل أكتر عن اختيار الكاميرات، الإعدادات، والتسجيل.

اختيار الكاميرات

لما تضغط اكشف الكاميرات، SkellyCam بيمسح كل كاميرات USB Video Class (UVC) المتوفرة. هاد بيشمل أغلب كاميرات USB (مثل Logitech C270, C920) وكاميرات اللابتوب المدمجة. الكاميرات الافتراضية (مثل OBS Virtual Camera) بتنفلتر افتراضياً.

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

API

كشف الكاميرات: POST /skellycam/camera/detect — إنشاء أو تحديث مجموعة كاميرات: POST /skellycam/camera/group/apply. شوف مرجع الـ API للتفاصيل.

إعداد الكاميرات

لقطة شاشة قريباً

لقطة شاشة للوحة إعدادات الكاميرا بالواجهة، بتبيّن الدقة، معدل الإطارات، التعريض، وضع التعريض، وإعدادات الدوران مع تسميات لكل عنصر تحكم.

كل كاميرا بالمجموعة فيك تعدّلها بشكل مستقل. لوحة الإعدادات بالواجهة بتخلّيك تعدّل الإعدادات التالية:

الإعداد	القيمة الافتراضية	الوصف
الدقة	1280 x 720	دقة الالتقاط بالبكسل. إذا الكاميرا ما بتدعم الدقة المطلوبة، OpenCV بيرجع لأقرب دقة مدعومة.
معدل الإطارات	افتراضي الكاميرا	معدل إطارات الالتقاط المستهدف. خلّيه على الافتراضي (-1) للتشغيل بأسرع ما يسمح العتاد، أو حدد قيمة معينة (مثلاً 30).
التعريض	-7	قيمة تعريض تعتمد على العتاد. أكتر سلبية = وقت تعريض أقصر. المدى الصالح بيعتمد على موديل كاميرتك.
وضع التعريض	MANUAL	اختار بين MANUAL، AUTO، أو RECOMMENDED.
الدوران	بدون	دوّر الصورة بالبرمجيات بعد الالتقاط: 90° مع عقارب الساعة، 180°، أو 90° عكس عقارب الساعة.

كيف بيشتغل وضع RECOMMENDED

وضع RECOMMENDED مش بس بيحط قيمة افتراضية. بيمرّ على عدة إعدادات تعريض وبيختار اللي مستوى واحد أقل من الإعداد اللي بيحط متوسط سطوع البكسل أقرب شي لنص الحد الأقصى (تقريباً 127.5 من 255). هاد بيعطي صورة أغمق شوي من اللي بنختارها عادةً للاستخدام العادي للكاميرا — خيار مقصود بيوازن بين الرؤية وأوقات التعريض المنخفضة لتقليل ضبابية الحركة. ملاحظة: الواجهة بتتذكر إعدادات الكاميرا بين الجلسات. استخدم Ctrl+R (تحديث كامل) لمسح الإعدادات المحفوظة.

API

إعدادات الكاميرا بتنبعت كجزء من مجموعة الكاميرات: POST /skellycam/camera/group/apply. شوف مرجع الـ API لمخطط الطلب الكامل.

التسجيل مع الصوت

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

API

كشف الميكروفونات: GET /skellycam/camera/microphone/detect. شوف مرجع الـ API للتفاصيل.

اضغط تسجيل للبدء. كل الكاميرات بتلتقط إطارات متزامنة بينما الصوت بيتسجل بالتوازي. اضغط إيقاف للإنهاء.

تسجيل الصوت مجال تطوير نشط:

عرض التسجيلات

روح لصفحة التسجيلات لتصفح جلساتك المحفوظة. كل تسجيل بيعرض بيانات وصفية:

• عدد الكاميرات
• حجم الملف
• المدة
• الـ FPS
• عدد الإطارات

التسجيلات مرتبة من الأحدث للأقدم.

التشغيل

اختار تسجيل لفتح عارض التشغيل بقفل الإطارات. الميزات الرئيسية:

• تزامن بقفل الإطارات — كل الكاميرات دايماً بتعرض نفس رقم الإطار، بدون انزلاق
• التقدم بالإطارات — تقدّم وارجع إطار واحد بالمرة
• سرعة متغيرة — عدّل سرعة التشغيل
• اختصارات لوحة المفاتيح — تحكّم بالتشغيل من لوحة المفاتيح

وين بتتحفظ التسجيلات

افتراضياً، التسجيلات بتتحفظ بـ ~/skellycam_data/recordings/. كل جلسة تسجيل بتاخد مجلدها الخاص مع ملفات فيديو متزامنة وبيانات الطوابع الزمنية.

لنظرة مفصّلة على بنية مجلد التسجيل ونموذج البيانات، شوف الدليل المتقدم.