Streams
Kelola seluruh CCTV/stream yang terhubung ke sistem — pantau status, tambah, edit, dan kelompokkan ke site.
Pengenalan
Halaman Streams adalah pusat manajemen seluruh kamera CCTV yang terhubung ke sistem Visionaire. Setiap stream merepresentasikan satu sumber video — baik kamera IP yang mengirim data via RTSP, maupun sumber RTMP dari Media Server — yang diproses oleh node Visionaire untuk menghasilkan event AI secara real-time. Dari halaman ini, operator dapat memantau status seluruh stream sekaligus, menambah kamera baru, mengedit konfigurasi yang sudah ada, dan mengatur pengelompokan berdasarkan lokasi.
Bagi integrator, semua operasi yang tersedia di UI juga dapat dilakukan melalui REST API. Endpoint Streams mendukung paginasi, filter multidimensi, mode Federation untuk deployment multi-instance, serta manajemen Tag untuk kategorisasi fleksibel. Setiap stream diidentifikasi secara unik oleh pasangan Node ID dan Stream ID — dua nilai ini wajib disertakan di setiap request yang mengakses atau memodifikasi stream tertentu.
Identitas sebuah stream ditentukan oleh kombinasi node_id (nomor node Visionaire tempat stream diproses) dan stream_id (pengenal unik stream dalam node tersebut). Keduanya selalu dipakai berpasangan di URL maupun parameter API — misalnya GET /api/streams/:nodeId/:streamId.
Cara Menggunakan
Melihat Daftar Stream
Buka halaman Streams
Navigasikan ke /streams dari sidebar. Secara default, tampilan menampilkan kartu besar (Large Card) dengan status filter Online. Gunakan tombol Tampilan di toolbar untuk beralih ke mode Kartu Sedang, Kartu Kecil, Wall, Tabel, atau Peta (jika fitur peta diaktifkan admin).
Gunakan filter untuk mempersempit daftar
Toolbar filter di bagian atas menyediakan beberapa opsi:
- Cari — ketik nama stream di kotak pencarian untuk filter real-time.
- Status — pilih antara Online, Offline, Nonaktif, atau Semua.
- Situs — saring stream berdasarkan site tempat stream ditetapkan.
- Analitik — tampilkan hanya stream yang menjalankan analitik tertentu.
- Node — filter berdasarkan nomor node Visionaire.
- Tags — pilih satu atau beberapa tag; gunakan koma untuk multi-tag.
- Instance — (mode Federation) pilih instance spesifik atau biarkan kosong untuk melihat semua instance secara agregat.
Baca informasi status
Setiap kartu stream menampilkan: nama stream, status (Online / Offline / Nonaktif), alamat stream, site yang ditetapkan, pipeline analitik aktif, dan tag. Badge berwarna hijau menandakan stream aktif dan terhubung; merah menandakan offline.
Menambah Stream Baru
Klik tombol Tambah Stream
Tombol ini tersedia di toolbar kanan atas halaman /streams. Dialog form akan muncul.
Isi informasi dasar
Lengkapi field berikut:
- Nama Stream — nama deskriptif untuk kamera (wajib).
- Alamat Stream — URL RTSP atau RTMP sumber video (wajib). Contoh:
rtsp://192.168.1.100:554/stream1. - Node — pilih node Visionaire yang akan memproses stream ini. Sistem hanya menampilkan node yang berstatus online.
- RTSP Transport — pilih protokol transport:
tcp(direkomendasikan untuk jaringan tidak stabil) atauudp.
Konfigurasi opsional
- Site — tetapkan stream ke satu atau lebih site untuk pengelompokan.
- Tag — tambahkan tag bebas untuk kategorisasi (contoh:
outdoor,entrance,hd). - Lokasi — atur koordinat latitude/longitude agar stream muncul di tampilan peta.
- Aktifkan Stream — toggle ini menentukan apakah stream langsung diproses setelah disimpan.
- Konfigurasi Recording — jika Media Server tersedia, aktifkan recording untuk menyimpan video ke NVR.
Simpan
Klik Tambah Stream. Sistem akan mendaftarkan stream ke node yang dipilih. Jika Pipeline belum ada untuk analitik yang dipilih, sistem akan membuat Pipeline secara otomatis. Stream baru akan segera muncul di daftar.
Pastikan URL RTSP/RTMP dapat diakses dari jaringan node Visionaire — bukan hanya dari browser Anda. Jika stream gagal online setelah ditambahkan, gunakan fitur Diagnosa Stream di halaman detail untuk memeriksa konektivitas.
Detail Stream
Klik nama stream atau tombol Lihat Detail pada kartu/baris tabel untuk membuka halaman detail di /stream/:nodeId/:streamId. Halaman ini menampilkan:
- Live Preview — feed video langsung dari stream (dengan overlay deteksi AI jika pipeline aktif).
- Informasi Stream — Node ID, Stream ID, alamat, status, koordinat, dan konfigurasi transport.
- Pipeline Aktif — daftar analitik yang sedang berjalan pada stream ini, beserta sub-logika yang dikonfigurasi.
- Statistik — FPS aktual, resolusi frame, error terakhir, dan histori aktivitas.
- Assignment — manajemen analitik: tambah atau hapus pipeline langsung dari halaman ini.
- Diagnostik — tab khusus untuk menjalankan ping, port check, atau stream probe (ffprobe) guna mendiagnosis masalah konektivitas.
- Aksi — tombol Edit Stream dan Hapus Stream tersedia di panel detail.
Group by Site
Akses /streams/site untuk melihat stream yang dikelompokkan berdasarkan site. Sidebar kiri menampilkan daftar site; klik site tertentu untuk membuka /streams/site/:siteId yang hanya menampilkan stream dari site tersebut.
Tampilan by-site mendukung filter analitik dan event panel di sisi kanan layar — berguna bagi operator yang memantau lokasi fisik tertentu. Di mode ini tersedia pula fitur Edit Layout dan Atur Urutan untuk menyesuaikan susunan kartu stream per site.
Filter & Tag
Filter status menggunakan parameter filter[stream_status] dengan nilai online atau offline. Untuk menyaring stream yang dinonaktifkan, gunakan filter[active]=false.
Filter Tag mendukung multi-tag dengan pemisah koma. Contoh: filter[tags]=outdoor,entrance akan menampilkan stream yang memiliki salah satu dari tag tersebut. Daftar tag yang tersedia dapat diambil melalui GET /api/streams/tags.
Filter Analitik menggunakan filter[analytic_id] — isi dengan ID analitik seperti NFDSS-FR untuk menampilkan hanya stream yang menjalankan Face Recognition.
Fitur Utama
Live Preview
Pantau feed video secara langsung dari halaman detail stream, lengkap dengan overlay hasil deteksi AI dari pipeline yang aktif.
Multi-Site Assignment
Satu stream dapat ditetapkan ke beberapa site sekaligus. Gunakan endpoint assign-sites atau form edit untuk mengatur penetapan ini.
Tag-based Filtering
Kategorikan stream dengan tag bebas (outdoor, entrance, hd, dll.) dan filter daftar menggunakan satu atau lebih tag secara bersamaan.
Federation Support
Dalam deployment multi-instance, gunakan parameter instance dan is_aggregated untuk menampilkan atau mengelola stream dari seluruh instance secara terpusat.
Pipeline Auto-Create
Saat stream baru ditambahkan dengan analitik yang dipilih, sistem secara otomatis membuat Pipeline di node yang sesuai tanpa konfigurasi manual.
Diagnostik Jaringan
Tab Diagnostik di halaman detail menyediakan tools ping, port check, dan stream probe berbasis ffprobe untuk menelusuri masalah konektivitas kamera.
API Reference
Dokumentasi endpoint lengkap (parameter, request body, contoh response, dan code sample dalam berbagai bahasa) tersedia di halaman terpisah:
Federation Mode
Federation memungkinkan satu dashboard Lenz mengelola stream dari beberapa instance Visionaire secara terpusat. Aktifkan mode ini melalui Preferensi → Fitur → Federation Mode.
Cara menggunakan parameter Federation:
- Gunakan
instance=<id>untuk menargetkan instance spesifik (contoh:instance=remote-jakarta). - Gunakan
is_aggregated=truetanpainstanceuntuk mengambil data dari seluruh instance secara gabungan. - Saat Federation aktif dan tidak ada
instanceyang dipilih, library secara otomatis menambahkanis_aggregated=true.
curl -X GET "${RAISA_API_URL}/api/streams?is_aggregated=true&filter[stream_status]=online" \
-H "Authorization: Bearer <token>"curl -X GET "${RAISA_API_URL}/api/streams?instance=remote-jakarta&filter[stream_status]=online" \
-H "Authorization: Bearer <token>"Pada respons Federation yang bersifat parsial (sebagian instance tidak merespons), body respons akan menyertakan field partial: true dan array errors yang berisi detail kegagalan per instance. Data stream yang berhasil diambil tetap ditampilkan.
Tips & Troubleshooting
Selanjutnya
Video Management
Kelola recording video, konfigurasi Media Server, dan playback rekaman dari stream.
Assignment
Kelola penetapan analitik ke stream dan konfigurasi pipeline secara lebih mendalam.
Sites
Buat dan kelola site (lokasi fisik) untuk mengelompokkan stream berdasarkan area.
Media Servers
Konfigurasi NVR dan Media Server untuk recording dan streaming RTMP.