التكاملات

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

قم بتنزيل تطبيق Agent DVR Remote لنظام Android .

قم بتنزيل تطبيق Agent DVR Remote لنظام iOS .

هناك واجهة برمجية لـ Python لوظائف واجهة المستخدم الأساسية هنا: agent-py .

يمكنك فتح Agent DVR لعرض معين بواسطة استدعاء عنوان URL الخاص به (حساس لحالة الأحرف):

• ?start=Live&viewIndex=3 (العرض المباشر على العرض 3)
• ?start=Live&viewIndex=3&ot=2&oid=2&max=true (العرض المباشر على العرض 3، معرف الكاميرا 2 بالحد الأقصى). "oid" هو معرف الكائن للجهاز (مرئي في أعلى الحوار عند تعديل الكاميرا)، "ot" هو نوع الكائن - 1 = ميكروفون، 2 = كاميرا.
• ?start=TimeMachine (عرض الآلة الزمنية)
• ?start=Timeline (عرض الخط الزمني)
• ?start=Photos (عرض الصور)
• ?start=Recordings (عرض التسجيلات)
• ?start=Floorplans&planIndex=2 (عرض المخططات الأرضية على الخطة 2)
• ?start=VR (الواقع الافتراضي)

يمكنك فتح Agent DVR بلغة معينة (تجاوز اختيار اللغة). ما عليك سوى تمرير رمز اللغة المكون من حرفين: ?lang=fr

يمكنك تمرير اسم عامل تصفية محفوظ لتطبيقه باستخدام معامل filter - مثال: ?start=Recordings&filter=intruder. يمكنك أيضا تمرير وقت البداية والنهاية للعامل باستخدام ticks جافا سكريبت. مثال ?start=timeline&from=1657841514949&to=1657852514949.

اضبط خيارات المظهر الافتراضي (خيارات المظهر متاحة في قائمة الحساب - إعدادات المظهر):

• ?theme=darkly&variant=dark&large=false
• ?theme=sketchy&variant=primary&large=true

تشغيل الصوت تلقائيا عند التحميل (قد يتطلب أيضا تغيير إعدادات المتصفح):

• ?playaudio=true

البدء في الوضع المصغر (أشرطة واجهة المستخدم العلوية والسفلية مخفية):

• ?mini=true

تمرير اسم المستخدم وكلمة المرور المحلية لتسجيل الدخول التلقائي (تحذير - سيعرض بيانات اعتمادك للشبكة):

• ?un=username&pwd=password

فتح تنبيه معين بواسطة معرف التنبيه (في json التنبيه):

• ?alertid=xxx

للوصول إلى الأوامر في Agent DVR، انقر على أيقونة الخادم في الزاوية العلوية اليمنى من واجهة Agent DVR، وحدد "Commands" ضمن System. الطريقة السريعة هي الضغط على "Alt-C".

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

استدعاء ملف سكريبت

لتنفيذ ملف سكريبت عام، ما عليك سوى إضافة ملف .bat (أو ملف .sh على Linux/macOS) إلى مجلد الأوامر. سيظهر اسم الملف (بدون امتداد) في قائمة الأوامر ويمكن النقر عليه للتشغيل. ملاحظة: قد تحتاج إلى إعادة تحميل الواجهة لكي يظهر.

استدعاء API

أنشئ ملف .bat جديد في مجلد Commands حيث يتم تثبيت Agent DVR. يجب أن يكون السطر الأول:

REM ispy-internal

يتم تفسير الأسطر اللاحقة كأوامر لـ API خاص بـ Agent DVR. على سبيل المثال:

 REM ispy-internal

 switchon&group=external

 switchoff&group=internal

 record&group=external

 broadcast 'external cameras are on and recording'

يتم إلحاق هذه الأوامر باستدعاءات API بالتنسيق /command.cgi?cmd=.... وبالتالي، يمكنك استخدام أي أمر متاح في API.

ستقوم الأوامر المثالية أعلاه بتفعيل جميع الأجهزة المسماة "external"، وتعطيل جميع أجهزة "internal"، والبدء في التسجيل على أجهزة "external"، وإرسال رسالة بث إلى جميع العملاء المتصلين.

راجع زر الأمر readme للحصول على أمثلة ووثائق API للحصول على قائمة الأوامر المتاحة.

بعد إعادة تحميل الواجهة والضغط على "Alt-C"، يجب أن يكون أمرك الجديد مرئياً في القائمة. انقر عليه لتنفيذه.

من الإصدار 3.8.1.0+، يمكنك استخدام أسماء المواقع في الأوامر (مثل switchon&location=home). فقط قم بتعيين موقع لأجهزتك أولاً!

من الإصدار 2.9.5.0، يقدم Agent DVR تكاملًا مع Amazon Alexa. تتيح لك هذه الميزة التحكم في Agent DVR باستخدام أوامر صوتية من خلال أجهزة Alexa الممكّنة. يمكنك تفعيل أو تعطيل النظام أو عرض تغذيات الفيديو الحية على أجهزة Alexa Show.

لتهيئته، حدد 'Alexa' تحت التكاملات في قائمة الخادم في Agent DVR. سيقوم هذا بإعادة توجيهك إلى Amazon لربط حساباتك.

بمجرد الربط، قم بتشغيل عملية اكتشاف Alexa. يجب أن تجد جهازين: لوحة الأمان وتحكم الكاميرا.

الآن يمكنك استخدام أوامر صوتية مثل:

• "Alexa، تفعيل Agent في وضع المنزل"
• "Alexa، عرض كاميرا Agent"

قم بتعيين رمز الأمان الخاص بك في إعدادات Agent DVR للعمليات التي تتطلب مصادقة. الرمز الافتراضي هو 1234.

تتطابق ملفات التعريف في Alexa (المنزل / خارج المنزل / ليلًا) مع تلك في Agent DVR. قم بتكوينها في الخادم - الملفات التعريفية.

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

يتكامل Agent DVR بشكل كامل مع Home Assistant، مما يسمح لك بإضافة Agent DVR إلى إعداد Home Assistant الخاص بك. يمكنك تضمين لوحة Agent DVR في واجهة lovelace أو تحديد كاميرات فردية. كما يتضمن تحكم للوحة الأمان الرئيسية. للمزيد من المعلومات، راجع رابط Home Assistant ضمن Server - Integrations.

يمكن لـ Agent DVR أيضًا نشر أجهزته إلى Home Assistant كأجهزة استشعار ومفاتيح عبر MQTT: راجع كشف Home Assistant MQTT.

تتيح لك IFTTT إعداد إجراءات ومشغلات مع أجهزة الإنترنت الأشياء. ابدأ بربط حسابك على IFTTT مع iSpyConnect.com، الذي يمكن الوصول إليه تحت الخادم - التكاملات.

إعداد تنبيهات الدفع على الهاتف المحمول مفصل في إعداد تنبيهات الدفع.

قم بربط Agent DVR مع الروبوت الدردشة على تليجرام للتحكم وتلقي تنبيهات الحية. قم بتمكين تنبيهات الدفع في إعدادات الجهاز لتلقي التنبيهات الحية. ابدأ بتحديد زر تليجرام تحت أيقونة الخادم في واجهة الويب البعيدة.

يمكن لـ Agent DVR إرسال التنبيهات إلى أي خدمة تقبل Webhooks الواردة، بما في ذلك Discord وSlack وMattermost وGoogle Chat وMicrosoft Teams وntfy. لا حاجة لربط الحسابات: تنشئ عنوان URL للـ Webhook في الخدمة المستهدفة ويرسل Agent DVR التنبيهات إليه مباشرة، لذا يعمل هذا أيضًا على الخوادم التي لا يوجد بها وصول عن بُعد.

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

• إذا: تنبيه (أو أي حدث آخر)
• ثم: استدعاء URL
• URL: عنوان URL للـ Webhook من الخدمة
• الطريقة: POST
• الجسم: الرسالة، بالتنسيق الموضح لكل خدمة أدناه

يمكنك استخدام الوسوم مثل {NAME} و{MESSAGE} و{AI} و{ZONE} في حقل الجسم لبناء الرسالة ديناميكيًا.

Content-Type: application/json

Discord

في Discord، افتح إعدادات القناة (أيقونة الترس) واختر عمليات الدمج - Webhooks - إنشاء Webhook، ثم نسخ عنوان URL للـ Webhook. في إجراء Agent DVR استخدم:

• URL: عنوان URL المنسوخ للـ Webhook
• الجسم:

  {"content":"{MESSAGE}: {NAME} على {SERVER} {AI}"}

لإرفاق لقطات بالرسالة على Discord، اضبط شريط رفع صورة على 1 أو أكثر (v7.8.7.0+). يتم التقاط كل صورة إضافية بفاصل نصف ثانية.

Slack

أنشئ تطبيق Slack على api.slack.com/apps، وفعّل Incoming Webhooks، وانقر على Add New Webhook to Workspace، واختر قناة وانسخ عنوان URL (يبدأ بـ hooks.slack.com). في إجراء Agent DVR استخدم:

• URL: عنوان URL المنسوخ للـ Webhook
• الجسم:

  {"text":"{MESSAGE}: {NAME} على {SERVER} {AI}"}

لا تدعم Webhooks الواردة في Slack سوى النصوص، لذا اترك رفع صورة على 0.

Mattermost

في Mattermost، انتقل إلى القائمة الرئيسية - عمليات الدمج - Webhooks الواردة - إضافة Webhook وارد، واختر قناة وانسخ عنوان URL. استخدم نفس تنسيق الجسم كما في Slack:

{"text":"{MESSAGE}: {NAME} على {SERVER}"}

Google Chat

في مساحة Google Chat (حسابات Workspace)، انقر على اسم المساحة واختر التطبيقات وعمليات الدمج - Webhooks - إضافة Webhook، ثم انسخ عنوان URL. استخدم نفس تنسيق الجسم كما في Slack:

{"text":"{MESSAGE}: {NAME} على {SERVER}"}

Microsoft Teams

في Teams، انقر على النقاط الثلاث بجوار القناة، واختر مهام سير العمل وأضف القالب النشر في قناة عند تلقي طلب Webhook، ثم انسخ عنوان URL الذي يعطيك إياه. يتطلب Teams الرسالة بصيغة Adaptive Card:

{"type":"message","attachments":[{"contentType":"application/vnd.microsoft.card.adaptive","content":{"type":"AdaptiveCard","version":"1.4","body":[{"type":"TextBlock","text":"{MESSAGE}: {NAME} على {SERVER}","wrap":true}]}}]}

ntfy

يرسل ntfy إشعارات فورية إلى هاتفك دون الحاجة إلى حساب، ويمكن أيضًا استضافته ذاتيًا. اختر اسم موضوع يصعب تخمينه (يمكن لأي شخص يعرفه الاشتراك فيه)، ثم:

• URL: https://ntfy.sh/your-topic-name
• الجسم: نص عادي (بدون JSON)، مثل

  {MESSAGE}: {NAME} على {SERVER}

• الترويسات (اختياري، واحدة في كل سطر):

  Title: Agent DVR
  Tags: rotating_light
  Priority: high

ثبّت تطبيق ntfy على هاتفك واشترك في موضوعك لتلقي التنبيهات.

خدمات أخرى

أي شيء يقبل HTTP POST يعمل بنفس الطريقة، على سبيل المثال مشغلات Webhook في Home Assistant ‏(http://homeassistant.local:8123/api/webhook/your-id - مع أن تكامل MQTT أغنى). يرسل Agent DVR أجسام JSON بتنسيق application/json وكل ما عداها بترميز النماذج. يمكنك إضافة ترويسات إضافية (مثل مفاتيح API) في حقل الترويسات، واحدة في كل سطر بصيغة Name: Value.