Integrasi
Aplikasi Seluler
Aplikasi mobile kami memungkinkan Anda terhubung melalui LAN Anda atau melalui layanan jarak jauh kami. Mereka tersedia untuk perangkat Android dan iOS.
Unduh Aplikasi Android Agent DVR Remote .
Unduh Aplikasi iOS Agent DVR Remote .
Pembungkus Python
Ada pembungkus python untuk fungsionalitas UI dasar di sini: agent-py .
Parameter URL
Anda dapat membuka Agent DVR ke tampilan tertentu dengan memanggil url Agent DVR dengan (case sensitive):
- ?start=Live&viewIndex=3 (tampilan langsung pada tampilan 3)
- ?start=Live&viewIndex=3&ot=2&oid=2&max=true (tampilan langsung pada tampilan 3, id kamera 2 dimaksimalkan). "oid" adalah object id perangkat (terlihat di bagian atas dialog saat Anda mengedit kamera), "ot" adalah tipe object - 1 = mikrofon, 2 = kamera.
- ?start=TimeMachine (tampilan timemachine)
- ?start=Timeline (tampilan timeline)
- ?start=Photos (tampilan foto)
- ?start=Recordings (tampilan rekaman)
- ?start=Floorplans&planIndex=2 (tampilan floorplans pada rencana 2)
- ?start=VR (realitas virtual)
Anda dapat membuka Agent DVR dengan bahasa tertentu (melewati pemilihan bahasa). Cukup masukkan kode bahasa 2 huruf: ?lang=fr
Anda dapat meneruskan nama filter tersimpan untuk diterapkan menggunakan parameter filter - misalnya: ?start=Recordings&filter=intruder. Anda juga dapat meneruskan waktu dari dan ke untuk filter menggunakan javascript ticks. misalnya ?start=timeline&from=1657841514949&to=1657852514949.
Atur opsi tema default (opsi tema tersedia di menu akun - pengaturan tema):
- ?theme=darkly&variant=dark&large=false
- ?theme=sketchy&variant=primary&large=true
Putar audio secara otomatis saat dimuat (mungkin juga memerlukan perubahan pengaturan browser):
- ?playaudio=true
Mulai dalam mode diminimalkan (bilah UI atas dan bawah tersembunyi):
- ?mini=true
Masukkan nama pengguna dan kata sandi lokal untuk login otomatis (peringatan - ini akan mengekspos kredensial Anda ke jaringan):
- ?un=username&pwd=password
Buka peringatan tertentu berdasarkan id peringatan (dalam json peringatan):
- ?alertid=xxx
Perintah
Untuk mengakses Commands di Agent DVR, klik ikon Server di pojok kanan atas UI Agent DVR, dan pilih "Commands" di bawah System. Jalan pintas cepat adalah dengan menekan "Alt-C".
Agent DVR menyertakan beberapa perintah siap pakai yang dapat mengontrol beberapa perangkat secara bersamaan. Perintah-perintah ini menggunakan API untuk melakukan berbagai tugas. Anda memiliki fleksibilitas untuk menambahkan perintah kustom Anda sendiri untuk memanggil API atau menjalankan perangkat lunak di komputer Anda.
Memanggil File Skrip
Untuk menjalankan file skrip generik, cukup tambahkan file .bat (atau file .sh di Linux/macOS) ke direktori commands. Nama file skrip (tanpa ekstensi) akan muncul dalam daftar Commands dan dapat diklik untuk dijalankan. Catatan: Anda mungkin perlu memuat ulang UI agar muncul.
Memanggil API
Buat file .bat baru di folder Commands tempat Agent DVR diinstal. Baris pertama harus:
REM ispy-internal
Baris ini menunjukkan bahwa file harus diproses secara internal oleh Agent DVR, bukan dijalankan sebagai aplikasi mandiri.
Baris-baris berikutnya ditafsirkan sebagai perintah untuk API Agent DVR. Contohnya:
REM ispy-internal
switchon&group=external
switchoff&group=internal
record&group=external
broadcast 'external cameras are on and recording'
Perintah-perintah ini ditambahkan ke panggilan API dalam format /command.cgi?cmd=.... Dengan demikian, Anda dapat menggunakan perintah apa pun yang tersedia dalam API.
Perintah contoh di atas akan mengaktifkan semua perangkat berlabel "external", menonaktifkan semua perangkat "internal", memulai perekaman pada perangkat "external", dan mengirimkan pesan broadcast ke semua klien yang terhubung.
Lihat tombol perintah readme untuk contoh dan dokumentasi API untuk daftar perintah yang tersedia.
Setelah memuat ulang UI dan menekan "Alt-C", perintah baru Anda akan terlihat dalam daftar. Klik untuk menjalankannya.
Dari versi 3.8.1.0+, Anda dapat menggunakan nama lokasi dalam perintah (misalnya, switchon&location=home). Cukup tetapkan lokasi ke perangkat Anda terlebih dahulu!
Amazon Alexa
Dari versi 2.9.5.0, Agent DVR menawarkan integrasi Amazon Alexa. Fitur ini memungkinkan Anda mengontrol Agent DVR menggunakan perintah suara melalui perangkat yang kompatibel dengan Alexa. Anda dapat mengaktifkan atau menonaktifkan sistem atau menampilkan feed video langsung pada perangkat Alexa Show.
Untuk mengatur, pilih 'Alexa' di bawah Integrasi dalam menu Server Agent DVR. Ini akan mengarahkan Anda ke Amazon untuk menghubungkan akun Anda.
Saat sudah terhubung, jalankan proses penemuan Alexa. Seharusnya menemukan dua perangkat: panel keamanan dan kontrol kamera.
Sekarang Anda dapat menggunakan perintah suara seperti:
- "Alexa, aktifkan Agent dalam mode rumah"
- "Alexa, tampilkan kamera Agent"
Atur kode keamanan Anda di Pengaturan Agent untuk operasi yang memerlukan otentikasi. Kode default adalah 1234.
Profil Alexa (Rumah / Pergi / Malam) sesuai dengan yang ada di Agent DVR. Konfigurasikan di Server - Profil.
Untuk server yang berbeda, atur nama server di pengaturan dan gunakan dalam perintah suara.
Asisten Rumah
Agent DVR terintegrasi sepenuhnya dengan Home Assistant, memungkinkan Anda menambahkan Agent DVR ke pengaturan Home Assistant Anda. Sematkan panel Agent DVR di UI lovelace atau pilih kamera individual. Ini juga mencakup kontrol untuk panel keamanan utama. Untuk informasi selengkapnya, lihat tautan Home Assistant di bawah Server - Integrations.
Agent DVR juga dapat menerbitkan perangkatnya ke Home Assistant sebagai sensor dan switch melalui MQTT: lihat Home Assistant MQTT discovery.
IFTTT (If This Then That)
IFTTT memungkinkan Anda mengatur tindakan dan pemicu dengan perangkat IoT. Mulailah dengan menghubungkan akun IFTTT Anda dengan iSpyConnect.com, dapat diakses di bawah Server - Integrasi.
Mendorong Pemberitahuan
Mengatur pemberitahuan dorongan mobile dijelaskan di Mengatur Pemberitahuan Dorongan.
Telegram
Hubungkan Agent DVR dengan chatbot Telegram untuk kontrol dan pemberitahuan alert langsung. Aktifkan Notifikasi Push dalam pengaturan perangkat untuk alert langsung. Mulailah dengan memilih tombol Telegram di bawah ikon Server dalam antarmuka web jarak jauh.
Webhook (Discord, Slack, dan lainnya)
Agent DVR dapat mengirim peringatan ke layanan apa pun yang menerima webhook masuk, termasuk Discord, Slack, Mattermost, Google Chat, Microsoft Teams, dan ntfy. Tidak perlu menautkan akun: Anda membuat URL webhook di layanan tujuan dan Agent DVR mengirim peringatan langsung ke sana, sehingga juga berfungsi pada server tanpa akses jarak jauh.
Pengaturan umumnya sama untuk semua layanan. Edit kamera atau mikrofon Anda, buka tab Aksi dan tambahkan aksi:
- Jika: Peringatan (atau peristiwa lain apa pun)
- Maka: Panggil URL
- URL: URL webhook dari layanan
- Metode: POST
- Tubuh (Body): pesan, dengan format yang ditunjukkan untuk setiap layanan di bawah
Anda dapat menggunakan tag seperti {NAME}, {MESSAGE}, {AI}, dan {ZONE} di bidang Tubuh untuk menyusun pesan secara dinamis.
Content-Type: application/json
Discord
Di Discord, buka pengaturan kanal (ikon roda gigi) dan pilih Integrasi - Webhook - Webhook Baru, lalu Salin URL Webhook. Pada aksi Agent DVR gunakan:
- URL: URL webhook yang disalin
- Tubuh (Body):
{"content":"{MESSAGE}: {NAME} di {SERVER} {AI}"}
Untuk melampirkan cuplikan ke pesan Discord, atur penggeser Unggah Gambar ke 1 atau lebih (v7.8.7.0+). Setiap gambar berikutnya diambil dengan jeda setengah detik.
Slack
Buat aplikasi Slack di api.slack.com/apps, aktifkan Incoming Webhooks, klik Add New Webhook to Workspace, pilih kanal dan salin URL-nya (diawali hooks.slack.com). Pada aksi Agent DVR gunakan:
- URL: URL webhook yang disalin
- Tubuh (Body):
{"text":"{MESSAGE}: {NAME} di {SERVER} {AI}"}
Webhook masuk Slack hanya mendukung teks, jadi biarkan Unggah Gambar pada 0.
Mattermost
Di Mattermost, buka Menu Utama - Integrasi - Webhook Masuk - Tambah Webhook Masuk, pilih kanal dan salin URL-nya. Gunakan format Tubuh yang sama dengan Slack:
{"text":"{MESSAGE}: {NAME} di {SERVER}"}
Google Chat
Di ruang Google Chat (akun Workspace), klik nama ruang dan pilih Aplikasi dan integrasi - Webhook - Tambahkan webhook, lalu salin URL-nya. Gunakan format Tubuh yang sama dengan Slack:
{"text":"{MESSAGE}: {NAME} di {SERVER}"}
Microsoft Teams
Di Teams, klik tiga titik di samping kanal, pilih Alur kerja dan tambahkan templat Kirim ke saluran saat permintaan webhook diterima, lalu salin URL yang diberikan. Teams memerlukan pesan dalam bentuk Adaptive Card:
{"type":"message","attachments":[{"contentType":"application/vnd.microsoft.card.adaptive","content":{"type":"AdaptiveCard","version":"1.4","body":[{"type":"TextBlock","text":"{MESSAGE}: {NAME} di {SERVER}","wrap":true}]}}]}
ntfy
ntfy mengirim notifikasi push ke ponsel Anda tanpa perlu akun, dan juga dapat dihosting sendiri. Pilih nama topik yang sulit ditebak (siapa pun yang mengetahuinya dapat berlangganan), lalu:
- URL: https://ntfy.sh/nama-topik-anda
- Tubuh (Body): teks biasa (bukan JSON), mis.
{MESSAGE}: {NAME} di {SERVER} - Header (opsional, satu per baris):
Title: Agent DVR Tags: rotating_light Priority: high
Pasang aplikasi ntfy di ponsel Anda dan berlangganan topik Anda untuk menerima peringatan.
Layanan lain
Apa pun yang menerima HTTP POST bekerja dengan cara yang sama, misalnya pemicu webhook Home Assistant (http://homeassistant.local:8123/api/webhook/id-anda - meskipun integrasi MQTT lebih lengkap). Agent DVR mengirim isi JSON sebagai application/json dan lainnya dengan enkode formulir. Anda dapat menambahkan header tambahan (misalnya kunci API) di bidang Header, satu per baris dalam bentuk Nama: Nilai.