Streams

Pengenalan

Bayangkan setiap kamera CCTV di lapangan sebagai satu saluran siaran — stream adalah representasi digital dari saluran itu di dalam Visionaire. Satu stream = satu sumber video yang sedang diproses oleh sistem, baik itu kamera IP di parkiran, kamera lobby gedung, maupun siaran RTMP dari Media Server. Di ruang kendali, halaman Streams adalah papan monitor pusat tempat semua saluran itu terlihat sekaligus.

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.

RTSP (Real-Time Streaming Protocol) adalah protokol standar yang digunakan oleh sebagian besar kamera IP untuk mengirimkan video — hampir semua kamera CCTV modern mendukungnya. RTMP (Real-Time Messaging Protocol) umumnya dipakai ketika video diteruskan lewat Media Server sebelum sampai ke Visionaire.

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.

Cara Menggunakan

Melihat Daftar Stream

Gunakan tampilan ini setiap kali Anda ingin memantau kondisi semua kamera secara sekilas — misalnya di awal shift jaga atau saat ada laporan insiden.

Buka halaman Streams

Navigasikan ke /streams dari sidebar. Secara default, tampilan menampilkan kartu besar (Large Card) dengan filter status Online — hanya stream yang sedang aktif yang ditampilkan.

Pilih mode tampilan

Klik ikon tampilan di toolbar untuk berganti mode visualisasi. Pilihan tersedia:

• Kartu Besar — preview video besar, cocok untuk memantau beberapa stream terpenting.
• Kartu Sedang / Kartu Kecil — lebih banyak stream sekaligus dalam satu layar.
• Tampilan Wall — grid tanpa jeda untuk video wall / control room, biasanya dipakai di layar besar.
• Tampilan Tabel — daftar dengan kolom Status, Alamat, Site, Pipeline; ideal untuk audit atau pencarian cepat.
• Tampilan Peta — penanda kamera di peta berdasarkan koordinat; berguna untuk memahami sebaran kamera secara geografis.

Pilihan tampilan dipertahankan antar kunjungan halaman.

Gunakan filter untuk mempersempit daftar

Toolbar filter di bagian atas menyediakan beberapa opsi:

• Cari — ketik nama stream untuk filter real-time.
• Status — Online, Offline, Nonaktif, atau Semua.
• Situs — saring berdasarkan site yang ditetapkan ke stream.
• Analitik — tampilkan hanya stream yang menjalankan analitik tertentu.
• Node — filter berdasarkan nomor node Visionaire.
• Tags — pilih satu atau beberapa tag; multi-tag menggunakan koma.
• Instance — (mode Federation) pilih instance spesifik atau biarkan kosong untuk agregasi semua instance.

Pahami arti status stream

Setiap kartu stream menampilkan nama, status, alamat, site, pipeline aktif, dan tag. Tabel di bawah menjelaskan arti masing-masing status:

Status	Warna	Artinya	Penyebab Umum	Tindakan
Online	Hijau	Stream aktif dan diproses normal	—	Tidak diperlukan
Offline	Merah	Stream aktif tapi tidak dapat terhubung ke sumber video	Kamera mati, kabel putus, jaringan bermasalah, URL salah	Buka detail stream → tab Diagnostik
Nonaktif	Abu-abu	Stream sengaja dinonaktifkan dan tidak diproses	Toggle dimatikan saat menambah/mengedit stream, atau melalui Bulk Action	Aktifkan kembali via Edit Stream atau Bulk Actions

Menambah Stream Baru

Lakukan ini setiap kali ada kamera baru yang dipasang di lapangan, atau ketika kamera lama dipindahkan ke node yang berbeda. Pastikan Anda sudah mengetahui alamat RTSP kamera sebelum memulai.

Klik tombol Tambah Stream

Tombol ini tersedia di toolbar kanan atas halaman /streams. Dialog form akan muncul.

Isi informasi dasar

Lengkapi field berikut:

Prop

Type

Nama Stream?string

Alamat Stream?string (wajib)

Node?pilihan

RTSP Transport?"tcp" | "udp"

Form akan memvalidasi alamat duplikat secara otomatis — jika stream dengan URL yang sama sudah ada, peringatan dengan tautan ke stream existing akan muncul.

Konfigurasi opsional

• Site — tetapkan stream ke satu atau lebih site untuk pengelompokan. Ini memudahkan filter dan tampilan per lokasi.
• Tag — tambahkan tag bebas untuk kategorisasi (contoh: outdoor, entrance, hd). Tag dapat digunakan untuk filter cepat.
• Lokasi — atur koordinat latitude/longitude agar stream muncul di Tampilan Peta. Jika dikosongkan, lokasi default Jakarta akan digunakan.
• Aktifkan Stream — toggle ini menentukan apakah stream langsung diproses setelah disimpan. Nonaktifkan jika kamera belum siap.
• Konfigurasi Recording — jika Media Server tersedia, aktifkan recording untuk menyimpan video ke NVR. Recording Hikvision dikelola sistem Hikvision dan membutuhkan Media Stream dari server Hikvision.

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.

Detail Stream

Klik nama stream atau ikon info pada kartu untuk membuka halaman detail di /stream/:nodeId/:streamId. Halaman ini berguna bagi operator yang ingin memeriksa kondisi satu kamera secara mendalam, atau bagi teknisi yang sedang mendiagnosis masalah.

Halaman ini menampilkan:

• Live Preview — feed video langsung dengan overlay deteksi AI dari pipeline aktif. Tersedia toggle Tampilkan Analitik, Tampilkan Face Match, Tampilkan Visualisasi, dan Tampilkan Auto Search.
• 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, kualitas, dan histori aktivitas.
• Assignment — manajemen analitik: tambah atau hapus pipeline langsung dari halaman ini, atau buka halaman penuh /assignment/:nodeId/:streamId.
• Diagnostik — tab untuk menjalankan alat diagnosis konektivitas jaringan (lihat bagian Diagnostik Stream di bawah).
• Recent Events — panel di samping yang menampilkan event-event terbaru dari stream (FR/LPR/People/Vehicle), dengan auto-search opsional.
• Floorplan — daftar floorplan tempat stream ditempatkan (bila fitur Floorplan aktif).
• Aksi — tombol Edit Stream, Hapus Stream, dan Salin Alamat tersedia di panel detail.

Group by Site

Halaman ini sangat berguna bagi operator yang bertanggung jawab atas satu lokasi fisik tertentu — misalnya supervisor gedung A yang hanya ingin melihat kamera-kamera di gedungnya, bukan seluruh jaringan.

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.

Skenario penggunaan: Sebuah operator keamanan bertugas memantau Gedung Kantor Pusat yang memiliki 12 kamera. Dengan membuka tampilan site "Gedung Kantor Pusat", ia langsung melihat semua kamera tersebut dalam satu grid yang bisa diatur tata letaknya sesuai denah fisik gedung — kamera lobby di slot kiri atas, kamera parkiran di bawah, dan seterusnya. Layout itu disimpan sebagai template sehingga esok hari saat ia buka kembali, susunan kamera tetap sama.

Tampilan by-site mendukung filter analitik dan event panel di sisi kanan layar. Di mode ini tersedia pula fitur:

• Edit Layout — atur grid 1×1, 2×2, 3×3, 4×4, atau template kustom sesuai kebutuhan layar.
• Atur Urutan — drag-and-drop untuk menyusun kartu stream per site sesuai denah fisik.
• Save Template — simpan layout sebagai template per site agar dapat diakses ulang di kunjungan berikutnya.
• Stream Pool Panel — panel untuk menyeret stream ke slot grid kosong.

Tampilan Peta

Tampilan Peta sangat berguna untuk memahami distribusi kamera secara geografis — misalnya saat merencanakan penambahan kamera baru, atau saat insiden terjadi dan Anda perlu tahu kamera mana yang paling dekat dengan lokasi kejadian.

• Cluster — kamera yang berdekatan dikelompokkan menjadi satu penanda dengan angka. Zoom in untuk memisahkan cluster dan melihat kamera individual.
• Tracking per kamera — aktifkan tracking pada kamera tertentu untuk menampilkan overlay rute pergerakan objek dari hasil deteksi People/Vehicle Analytics. Berguna untuk memantau pola pergerakan di area tertentu.
• Klik penanda kamera untuk melihat thumbnail live dan informasi dasar stream.

Agar kamera muncul di peta, koordinat latitude/longitude harus diisi saat menambah atau mengedit stream.

Bulk Actions

Bulk Actions menghemat waktu ketika Anda perlu mengelola banyak stream sekaligus — misalnya menonaktifkan semua kamera dari satu node yang akan dimaintenance, atau menetapkan 20 kamera baru ke site yang sama.

Pilih beberapa stream sekaligus dengan checkbox di kartu/tabel, lalu gunakan menu Aksi (N) di toolbar untuk menjalankan operasi massal:

Bulk operations dilakukan iteratif menggunakan endpoint CRUD standar. Selama proses berjalan, dialog menampilkan progres n / total, daftar yang sudah selesai, dan daftar error per item. Anda dapat membatalkan dengan tombol Batalkan Proses — stream yang sudah diproses tidak akan di-rollback.

Import & Export

Import CSV adalah cara tercepat untuk mendaftarkan banyak kamera sekaligus, misalnya saat pertama kali menyiapkan sistem untuk satu gedung baru.

Format CSV: Ekspor terlebih dahulu untuk mendapatkan template dengan kolom yang benar, lalu edit di spreadsheet dan impor kembali.

Kolom-kolom yang didukung:

Contoh satu baris CSV:

stream_name,stream_address,stream_node_num,stream_latitude,stream_longitude,active,rtsp_transport,sites,tags
Pintu Masuk Utama,rtsp://192.168.1.100:554/stream1,1,-6.2088,106.8456,true,tcp,GedungA/Lobby,entrance;hd

Import dari CSV — klik Kelola Stream → Impor Stream di toolbar untuk membuka dialog upload. Sistem akan:

1. Mem-parsing file CSV dan memvalidasi setiap baris (nama, alamat, node, dst.).
2. Mendeteksi alamat atau nama duplikat dan meminta konfirmasi: pilih duplikat yang tetap diimpor.
3. Opsi Gunakan Rekomendasi Node akan otomatis memilih node dengan beban GPU/CPU/memori paling rendah, mengabaikan kolom stream_node_num di CSV.
4. Menampilkan ringkasan stream Valid / Duplikat / Error sebelum eksekusi.

Export ke CSV — klik Kelola Stream → Ekspor Stream untuk mengunduh seluruh daftar stream (bukan hanya yang tampil di halaman saat ini). File menggunakan kolom standar yang kompatibel dengan flow import, sehingga Anda dapat: ekspor → edit di spreadsheet → impor kembali.

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.

Diagnostik Stream

Ketika sebuah stream berstatus Offline, fitur Diagnostik adalah tempat pertama yang harus dibuka. Diagnostik mengirimkan perintah jaringan dari server Visionaire (bukan dari browser Anda) langsung ke kamera — sehingga hasilnya mencerminkan kondisi konektivitas yang sebenarnya.

Untuk mengakses Diagnostik:

1. Klik ikon info pada kartu stream, atau buka halaman detail stream.
2. Pilih tab Diagnostik.

Alat Diagnostik yang Tersedia

Langkah Diagnosa Saat Stream Offline

Fitur Utama

Federation Mode

Jika organisasi Anda menjalankan Visionaire di beberapa pusat data atau lokasi terpisah, Federation memungkinkan satu dashboard Lenz melihat dan mengelola stream dari semua lokasi sekaligus — tanpa harus membuka dashboard yang berbeda untuk setiap lokasi. Operator cukup memilih "tampilkan semua" atau memilih satu instance spesifik dari dropdown filter.

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=true tanpa instance untuk mengambil data dari seluruh instance secara gabungan.
• Saat Federation aktif dan tidak ada instance yang dipilih, sistem secara otomatis menambahkan is_aggregated=true.

curl -X GET "${API_URL}/api/streams?is_aggregated=true&filter[stream_status]=online" \
  -H "Authorization: Bearer <token>"

curl -X GET "${API_URL}/api/streams?instance=remote-jakarta&filter[stream_status]=online" \
  -H "Authorization: Bearer <token>"

Tips & Troubleshooting

Selanjutnya