Agent DVR: الإضافات

تثبيت الإضافات

أسهل طريقة لتثبيت الإضافات هي من خلال بوابة الويب عن بُعد. بمجرد الاتصال، انقر على أيقونة الخادم في الزاوية اليسرى العلوية وانتقل إلى 'الإضافات' تحت النظام. هنا، يمكنك اختيار الإضافة التي ترغب في استخدامها من القائمة المنسدلة في الزاوية اليمنى العلوية وانقر على 'تثبيت' للبدء.

تفضل بالتثبيت يدويًا؟ لا مشكلة! يمكنك بناء الإضافات من المصدر ثم نسخ الناتج المبني إلى Agent/Plugins/اسم الإضافة. تعطيك هذه الطريقة مزيدًا من التحكم في عملية التثبيت.

الإضافات المتاحة

يأتي Agent DVR محملاً بميزات معالجة الفيديو المتقدمة مثل تكامل CodeProject AI، بالإضافة إلى تتبع الكائنات المتقدم واعتراف الصوت ومُعدِّلات العد. لتعزيز تجربتك بشكل أكبر، نقدم مجموعة من الإضافات التي يمكنك استخدامها في AgentDVR لتوسيع وظائفه.

قائمة الإضافات

الرموز الشريطية
امسح تقريبًا أي رمز شريطي من كاميرا (فقط لنظام التشغيل ويندوز).

الأحداث المرتفعة: تم التعرف على الرمز الشريطي
يدعم: الفيديو

لقطة الشاشة
الكسب
قم بتطبيق مرشحات الصوت المباشرة على الصوت القادم من أجهزة الصوت.

الأحداث المرتفعة: لا شيء
يدعم: الصوت

لقطة الشاشة
التأخير الحي
يضيف تأخيرًا للصوت والفيديو الحي (مفيد لتحليل الرياضة).

Raised Events: None
Supports: Video, Audio

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

معلومات كاملة:

{icon}{main}: {description} 
 Wind: {wind} Gust: {gust} 
 Temp: {temp} Feels Like: {feelsLike} 
 Humidity: {humidity} UVI: {uvi}

رمز فقط:

{icon}

سطر واحد:

{main} {wind} {temp} {humidity} UVI: {uvi}

الأحداث المثيرة: درجة حرارة عالية، هبة، حالة
يدعم: الفيديو

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

تكوين الإضافات

هل أنت مستعد لاستخدام قوة الإضافات؟ ما عليك سوى إضافة جهاز (كاميرا و/أو ميكروفون) والانتقال إلى إعدادات التحرير الخاصة به. ابحث عن علامة التبويب Plugins في القائمة المنسدلة في أعلى اليمين. هنا، يمكنك تحديد الإضافة التي ترغب فيها والنقر على الزر "..." لتكوينها حسب احتياجاتك.

تثير بعض الإضافات أحداثًا يمكنك ربط الإجراءات بها. تثير إضافة الطقس، على سبيل المثال، حدثًا يُسمى Gust عندما تتجاوز الرياح العاتية قيمة محددة (يمكن تكوينها في الإضافة). يمنحك تحرير الكاميرا والانتقال إلى علامة التبويب الإجراءات خيارات للرد على هذا الحدث - مثل إصدار إنذار أو بدء تسجيل على سبيل المثال. ما عليك سوى تحديد اسم الإضافة: الحدث - على سبيل المثال Weather: Gust في مربع الاختيار If وتعيين إجراء.

أنشئ إضافتك الخاصة

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

لبدء إنشاء إضافات لـ Agent DVR، يجب تطويرها كمشاريع .Net Standard 2.0، متوافقة عبر جميع الأنظمة. ابدأ بنسخ إضافاتنا مفتوحة المصدر من https://github.com/ispysoftware/AgentDVR-Plugins. ستحتاج إلى نسخة حديثة من Visual Studio لبنائها.

نوصي بالبدء بالإضافة التجريبية كقاعدة. تأكد من أن لديك أحدث إصدار من Agent مثبت. بعد بناء الإضافة التجريبية، انسخ جميع الملفات من Demo\bin\Debug\netstandard2.0 إلى Agent\Plugins\Demo\. أعد تشغيل Agent DVR، عدل كاميرا، وانتقل إلى علامة الإضافات. قم بتمكين الإضافة، حدد Demo من القائمة المنسدلة، وانقر على الزر "..." لتكوينها.

الإضافة التجريبية متوافقة تمامًا مع جميع الأنظمة وتعرض الوظائف الشاملة التي يمكنك بناؤها باستخدام الإضافات. تتضمن تأثيرات الفيديو الحية، والتراكبات الرسومية، والتحكم في مستوى الصوت الحي، والتكامل مع نظام الأحداث في Agent DVR. يوفر قائمة الإضافات رؤى حول كيفية عمل مختلف عناصر التحكم في الإدخال.


ملاحظات الإضافة للمطورين:

التكوين: يمزج Agent DVR بين XML و XSD و JSON لتخزين الإعدادات والتقديم. لتحرير ملف config.xsd، استخدم محرر XML (نص) في Visual Studio مع الترميز. بعد إضافة الحقول اللازمة، قم بإنشاء ملف فئة C# باستخدام الأمر C:\Program Files (x86)\Microsoft SDKs\Windows\v10.0A\bin\NETFX 4.8 Tools\xsd.exe /c config.xsd في دليل ملف xsd.

تعتمد عملية تقديم تكوين Agent DVR وتحديث XML على ملفات .json. قم بتحرير config_en.json في دليل json لعرض واجهة المستخدم، حيث يمكنك إضافة عدة أقسام تُقدم كعلامات تبويب. ترتبط الحقول الرئيسية 'bindto' في json بحقول تكوين XML. يقوم Agent DVR بتلقيم عملية تقديم التحكم، تخزين الإعدادات، والتحديثات.

إضافة "live": true إلى إدخالات json تمكن التحديثات الفورية دون الانتظار لنقرة زر OK، مما يعتبر رائعًا لضبط البث المباشر. يستخدم الحقل 'converter' 'PopulateResponse' في Utils.cs لتنسيق القيم.

دعم الوسائط: اختر معالجة "الفيديو"، "الصوت"، أو كلاهما. يمكن تعيين الحقل 'Supports' في Main.cs بشكل ثابت.

معالجة مستمرة: يتم إرسال كل إطار فيديو وصوت من الجهاز إلى الإضافة للتحليل أو المعالجة، كما هو موضح في العرض التوضيحي.

معالجة الحركة/التنبيه: قم بمعالجة الإطارات عند حدوث حركة أو تنبيهات عن طريق استخدام طريقة 'ProcessEvent' في إضافة العرض التوضيحي. يتيح هذا معالجة الإطارات فقط أثناء هذه الأحداث.

الأحداث المخصصة: يجب أن يُرجع الأسلوب 'GetCustomEvents' في البرنامج المساعد الخاص بك قائمة بالأحداث المخصصة التي يولدها. تظهر هذه الأحداث بعد ذلك تحت الإجراءات في قائمة 'If' في واجهة المستخدم Agent DVR. قم بتشغيل هذه الأحداث باستخدام عنصر 'Result'، محددًا اسم الإجراء و MSG الاختياري، Tag، Filename، و AIJSON.

تنبيه، اكتشاف، ووسم: قم برفع التنبيهات أو اكتشاف الأحداث عن طريق إضافة نتيجة بـ "alert" أو اسم "detect" للحدث. قم بوسم التسجيلات الجارية بحدث 'tag' وقم بتعيين الوسوم حسب الحاجة.

مكالمات API: يقوم Agent DVR بتهيئة البرامج المساعدة بمعلومات الجهاز ومنفذ الخادم المحلي، مما يكون مفيدًا لأوامر واجهة برمجة التطبيقات للجهاز. يتم أيضًا تعيين الخصائص AppDataPath و AppPath لعرض المواقع أو حفظ الملفات.

التوزيع: هل قمت بإنشاء برنامج مساعد رائع أو مفيد؟ شاركه معنا وساهم في المجتمع!