التكاملات: التكاملات

واجهة برمجة التطبيقات

تم نقل أمثلة ومستندات واجهة برمجة التطبيقات إلى https://ispysoftware.github.io/Agent_API/

الغلاف البرمجي لبايثون

هناك واجهة برمجية لـ 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، واختر "الأوامر" تحت النظام. يمكنك الاختصار عن طريق الضغط على "C".


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

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

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

استدعاء واجهة التطبيقات

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

تذكر استخدام & بدلاً من ? لفصل المعلمات في أوامرك.

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