التكاملات
تطبيقات الهاتف المحمول
تتيح لك تطبيقاتنا المحمولة الاتصال عبر الشبكة المحلية أو من خلال خدماتنا البعيدة. وهي متاحة لكل من أجهزة Android و iOS.
قم بتنزيل تطبيق Agent DVR Remote لنظام Android .
قم بتنزيل تطبيق Agent DVR Remote لنظام iOS .
الغلاف البرمجي لبايثون
هناك واجهة برمجية لـ Python لوظائف واجهة المستخدم الأساسية هنا: agent-py .
معلمات عنوان URL
يمكنك فتح Agent DVR إلى عرض محدد عن طريق استدعاء عنوان URL الخاص بـ Agent DVR مع (حساس لحالة الأحرف):
- ?start=Live&viewIndex=3 (عرض مباشر على العرض 3)
- ?start=TimeMachine (عرض آلة الزمن)
- ?start=Timeline (عرض الجدول الزمني)
- ?start=Photos (عرض الصور)
- ?start=Recordings (عرض التسجيلات)
- ?start=Floorplans&planIndex=2 (عرض الخرائط الطابقية على الخطة 2)
- ?start=VR (الواقع الافتراضي)
يمكنك فتح Agent DVR بلغة معينة (تجاوز اختيار اللغة). ما عليك سوى تمرير رمز اللغة المكون من حرفين: ?lang=fr
يمكنك تمرير اسم عامل تصفية محفوظ لتطبيقه باستخدام معلمة التصفية - على سبيل المثال: ?start=Recordings&filter=intruder. يمكنك أيضًا تمرير وقت البداية والنهاية للتصفية باستخدام علامات JavaScript. على سبيل المثال: ?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
الأوامر
للوصول إلى الأوامر في Agent DVR، انقر على أيقونة الخادم في أعلى الواجهة الرسومية لـ Agent DVR، واختر "الأوامر" تحت النظام. يمكنك الاختصار عن طريق الضغط على "Alt - C".
يتضمن Agent DVR عدة أوامر مدمجة يمكنها التحكم في عدة أجهزة بشكل متزامن. تستخدم هذه الأوامر واجهة API لأداء مهام مختلفة. لديك المرونة في إضافة أوامر مخصصة خاصة بك لاستدعاء API أو تشغيل برامج على جهاز الكمبيوتر الخاص بك.
استدعاء ملف نصي
لتنفيذ ملف نصي عام، قم بإضافة ملف .bat (أو .sh على نظام Linux/macOS) إلى دليل الأوامر. سيظهر اسم ملف النص (بدون الامتداد) في قائمة الأوامر ويمكن النقر عليه للتشغيل. ملاحظة: قد تحتاج إلى إعادة تحميل الواجهة الرسومية لكي يظهر.
استدعاء واجهة التطبيقات
أنشئ ملف .bat جديدًا في مجلد الأوامر حيث تم تثبيت Agent DVR. يجب أن تكون السطر الأول كالتالي:
REM ispy-internal
يشير هذا السطر إلى أنه يجب معالجة الملف داخليًا بواسطة Agent DVR، وليس تنفيذه كتطبيق مستقل.
يتم تفسير الأسطر التالية على أنها أوامر لـ API الخاص بـ Agent DVR. على سبيل المثال:
REM ispy-internal
switchon&group=external
switchoff&group=internal
record&group=external
broadcast 'external cameras are on and recording'
تُلحَق هذه الأوامر بمكالمات واجهة برمجة التطبيقات بتنسيق /command.cgi?cmd=.... بالتالي، يمكنك استخدام أي أمر متاح في واجهة برمجة التطبيقات.
سيُنشط الأوامر المثالية أعلاه جميع الأجهزة المعلّمة بـ "خارجية"، ويعطل جميع الأجهزة "الداخلية"، ويبدأ التسجيل على الأجهزة "الخارجية"، ويُرسل رسالة بث إلى جميع العملاء المتصلين.
راجع زر الأمر readme للحصول على أمثلة ووثائق واجهة برمجة التطبيقات للحصول على قائمة بالأوامر المتاحة.
بعد إعادة تحميل واجهة المستخدم والضغط على "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 في واجهة المستخدم لوفلاس أو اختر الكاميرات الفردية. كما يتضمن تحكمًا للوحة الأمان الرئيسية. لمزيد من المعلومات، انظر الرابط الخاص بـ Home Assistant تحت Server - Integrations.
إذا (If) ثم (Then) ذلك (That)
تتيح لك IFTTT إعداد إجراءات ومشغلات مع أجهزة الإنترنت الأشياء. ابدأ بربط حسابك على IFTTT مع iSpyConnect.com، الذي يمكن الوصول إليه تحت الخادم - التكاملات.
تنبيهات الدفع
إعداد تنبيهات الدفع على الهاتف المحمول مفصل في إعداد تنبيهات الدفع.
تليجرام
قم بربط Agent DVR مع الروبوت الدردشة على تليجرام للتحكم وتلقي تنبيهات الحية. قم بتمكين تنبيهات الدفع في إعدادات الجهاز لتلقي التنبيهات الحية. ابدأ بتحديد زر تليجرام تحت أيقونة الخادم في واجهة الويب البعيدة.
Webhooks (Discord وSlack والمزيد)
يمكن لـ 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.