التكاملات

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

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

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

يوجد غلاف Python لوظائف الواجهة الأساسية هنا: agent-py .

يمكنك فتح Agent DVR إلى عرض معين باستدعاء رابط Agent DVR مع (حساس لحالة الأحرف):

• ?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

يمكنك تمرير اسم عامل تصفية محفوظ لتطبيقه باستخدام معامل عامل التصفية - مثل: ?start=Recordings&filter=intruder. يمكنك أيضاً تمرير وقت البداية والنهاية لعامل التصفية باستخدام علامات جافاسكريبت. مثل ?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، وحدد "الأوامر" ضمن النظام. الطريقة السريعة هي الضغط على "Alt-C".

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

استدعاء ملف نصي

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

استدعاء API

أنشئ ملف .bat جديد في مجلد الأوامر حيث تم تثبيت 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 للحصول على قائمة بالأوامر المتاحة.

بعد إعادة تحميل واجهة المستخدم والضغط على "Shift-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 ضمن الخادم - التكاملات.

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

تفضل السؤال باللغة العادية؟ يعمل Agent DVR أيضًا مع مساعدو AI مثل Claude و ChatGPT و Gemini CLI؛ انظر اتصال مساعد AI.

ioBroker يمكن لمستخدمي ioBroker ربط Agent DVR بمحول ioBroker.agent-dvr الذي يحتفظ به المجتمع (متوفر أيضًا على npm). يتواصل مع Agent DVR عبر HTTP API المحلي ، لذا فإنه يعمل مع الإصدار المجاني على شبكتك الخاصة.

ما تحصل عليه

• نقاط البيانات: يتم اكتشاف كل كاميرا تلقائيًا وتنعكس خصائصها (متصل، تسجيل، تم اكتشافه، تنبيه، الدقة والمزيد) كحالات ioBroker للاستخدام في البرامج النصية والتصورات.
• عناصر التحكم: تسجيل، لقطة، تفعيل وتعطيل، تشغيل وإيقاف، تبديل الكاشف والجدول الزمني، الحساسية، PTZ مع الإعدادات المسبقة، وتفعيل وتعطيل وتحديد الملف الشخصي وإعادة تشغيل على مستوى النظام.
• لوحة تحكم مباشرة والتسجيلات: لوحة تحكم مدمجة يوفرها ioBroker مع تدفقات MJPEG أو FLV أو go2rtc لكل كاميرا، بالإضافة إلى متصفح التسجيلات مع التشغيل والحذف.
• التحديثات الفورية: أضف عنوان URL webhook الخاص بالمحول كإجراء استدعاء URL في Agent DVR بحيث يقوم ioBroker بالتحديث فورًا عند التنبيهات والتسجيلات الجديدة بدلاً من انتظار الاستطلاع التالي.

الإعداد

• ثبّت المحول من ioBroker admin (يتطلب محول iobroker.web).
• أدخل عنوان IP وبوابة Agent DVR (الافتراضية 8090) في علامة الاتصال الخاصة بالمحول. إذا كان Agent DVR مزودًا بـ تسجيل دخول معروّف، أدخل نفس اسم المستخدم وكلمة المرور.
• استخدم Agent DVR الإصدار 7.8.0.0 أو أحدث لتشغيل التسجيلات في لوحة التحكم الخاصة بالمحول.

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

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

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

أوامر الروبوت

• /list - اعرض قائمة الخوادم المتصلة
• /command - أرسل أمراً إلى خادم Agent DVR
• /groupalerts - (في مجموعة) أرسل التنبيهات إلى هذه المجموعة
• /privatealerts - (في الدردشة الخاصة) أرسل التنبيهات إلى هذه الدردشة الخاصة

يمكن لـ 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 - New Webhook، ثم Copy Webhook URL. في إجراء Agent DVR استخدم:

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

  {"content":"{MESSAGE}: {NAME} on {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} on {SERVER} {AI}"}

Slack الـ incoming webhooks خاصة بالنصوص فقط، لذا اترك رفع صورة على 0.

Mattermost

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

{"text":"{MESSAGE}: {NAME} on {SERVER}"}

Google Chat

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

{"text":"{MESSAGE}: {NAME} on {SERVER}"}

Microsoft Teams

في Teams، انقر على النقاط الثلاث بجانب قناة، اختر Workflows وأضف القالب Post to a channel when a webhook request is received، ثم انسخ عنوان 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} on {SERVER}","wrap":true}]}}]}

ntfy

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

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

  {MESSAGE}: {NAME} on {SERVER}

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

  Title: Agent DVR
  Tags: rotating_light
  Priority: high

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

خدمات أخرى

أي شيء يقبل HTTP POST يعمل بنفس الطريقة، على سبيل المثال Home Assistant webhook triggers (http://homeassistant.local:8123/api/webhook/your-id - على الرغم من أن تكامل MQTT أكثر ثراءً). ترسل Agent DVR أجسام JSON كـ application/json وأي شيء آخر كـ form encoded. يمكنك إضافة ترويسات إضافية (على سبيل المثال مفاتيح API) في حقل الترويسات، واحد لكل سطر بصيغة الاسم: القيمة.