Assignment
Konfigurasi dan tugaskan analitik AI ke video stream tertentu — mulai dari pemilihan analitik, penggambaran Region of Interest, hingga penyimpanan konfigurasi Pipeline.
Pengenalan
Assignment adalah proses menghubungkan satu analitik AI dengan satu video stream tertentu. Setelah assignment dibuat, sistem akan membangun Pipeline pemrosesan yang menjalankan inferensi AI secara real-time terhadap frame dari stream yang ditentukan.
Setiap analitik yang di-assign dapat dikonfigurasi dengan parameter spesifik: area deteksi melalui gambar poligon atau garis (Region of Interest), arah penghitungan, logika analisis (counting, dwelling, density, speed), threshold kepercayaan deteksi, dan konfigurasi lanjutan berbasis JSON. Konfigurasi ini disimpan sebagai bagian dari Pipeline stream dan langsung berlaku tanpa membutuhkan restart layanan.
Halaman Assignment dapat diakses melalui dua mode:
- Tambah Penugasan — untuk menghubungkan analitik baru ke stream
- Perbarui Penugasan — untuk mengubah konfigurasi analitik yang sudah aktif
Analitik yang ditampilkan dalam daftar pilihan hanya yang memiliki lisensi aktif (seat tersedia). Analitik tanpa seat tidak akan muncul di dropdown pemilihan.
Mode Perbarui Penugasan akan menghapus konfigurasi lama terlebih dahulu sebelum menyimpan yang baru. Pastikan seluruh parameter sudah benar sebelum menyimpan.
Tipe Analitik yang Didukung
Face Recognition (FR)
Deteksi dan pengenalan wajah dari enrolled person. Mendukung konfigurasi ROI whitelist/blacklist untuk area deteksi spesifik.
License Plate Recognition (LPR)
Pembacaan plat nomor kendaraan secara real-time. Cocok untuk manajemen akses dan pemantauan lalu lintas.
People Analytics
Analitik berbasis orang: counting (penghitungan lewat garis), dwelling (waktu tinggal), density (kepadatan area), dan speed (estimasi kecepatan).
Vehicle Analytics
Analitik berbasis kendaraan dengan logika yang sama: counting, dwelling, density, dan speed — dikalibrasi untuk objek berukuran kendaraan.
Crowd Estimation
Estimasi jumlah kerumunan dalam satu frame tanpa tracking individu. Cocok untuk pemantauan area publik.
Cara Menggunakan
Menambah atau Memperbarui Penugasan
Buka halaman Assignment
Navigasikan ke /assignment/:nodeId/:streamId melalui halaman detail stream. Klik tombol Tambah Analitik untuk mode tambah, atau klik ikon Edit pada analitik yang sudah aktif untuk mode perbarui.
Halaman akan menampilkan informasi stream di panel kiri atas, termasuk nama stream dan ID stream yang sedang dikonfigurasi.
Pilih Analitik
Pada kartu Konfigurasi Penugasan, klik dropdown Pilih Analitik dan pilih analitik yang ingin Anda tugaskan. Daftar hanya menampilkan analitik dengan lisensi aktif yang belum (atau sudah) di-assign ke stream ini, sesuai mode yang Anda gunakan.
Untuk analitik yang mendukung multi-logika — seperti People Analytics (NFV4-MPA) dan Vehicle Analytics (NFV4-MVA) — setelah memilih analitik, dropdown Pilih Logika akan muncul. Pilih salah satu logika yang tersedia:
- Counting — penghitungan objek melewati garis (menggunakan ROI bertipe garis)
- Dwelling — deteksi durasi objek berada di area tertentu (menggunakan ROI bertipe poligon)
- Density — pengukuran kepadatan objek di area tertentu (menggunakan ROI bertipe poligon)
- Speed — estimasi kecepatan objek, memerlukan kalibrasi bidang (menggunakan ROI bertipe poligon)
Satu stream dapat memiliki beberapa logika dari analitik yang sama secara bersamaan. Misalnya, Anda dapat mengaktifkan counting dan dwelling dari analitik People Analytics dalam satu stream secara paralel.
Gambar Region of Interest (ROI)
Panel kanan menampilkan frame terkini dari stream sebagai kanvas gambar. Tipe ROI yang perlu digambar tergantung pada analitik dan logika yang dipilih:
- Garis — untuk logika counting; klik dua titik untuk menggambar garis crossing. Setiap garis memiliki arah (
in,out, atauboth) dan dapat dikonfigurasi entry/exit untuk dwelling. - Poligon — untuk logika dwelling, density, dan speed, serta untuk FR dan LPR; klik minimal tiga titik untuk membentuk area, tutup dengan klik titik pertama atau double-click.
- Full Frame — beberapa analitik memproses seluruh frame tanpa perlu menggambar area; kanvas akan menampilkan pesan konfirmasi.
Anda dapat menggambar beberapa area sekaligus. Setiap area dapat diberi nama dan dikonfigurasi secara independen. Untuk menghapus area, pilih area di kanvas dan tekan tombol hapus.
Gunakan tombol Preset di pojok kanan atas kanvas untuk menyimpan konfigurasi ROI saat ini sebagai preset atau memuat preset yang sebelumnya disimpan — berguna untuk konfigurasi berulang pada kamera dengan sudut pandang serupa.
Untuk logika speed, aktifkan Kalibrasi Bidang di bawah kanvas dan masukkan dimensi nyata area dalam satuan meter. Sistem akan menggunakan kalibrasi ini untuk menghitung estimasi kecepatan objek.
(Opsional) Konfigurasi Parameter Lanjutan
Aktifkan toggle Aktifkan Konfigurasi Kustom di kartu Pengaturan Lanjutan untuk mengakses parameter tambahan. Tersedia dua mode tampilan:
- Konfigurasi Sederhana — form terstruktur dengan field yang spesifik per analitik (threshold, interval, dan lainnya)
- JSON Lanjutan — editor JSON untuk memasukkan konfigurasi secara bebas, cocok untuk parameter yang belum tersedia di form sederhana
Anda juga dapat memuat Preset Konfigurasi yang telah disiapkan sebelumnya melalui tombol Muat Preset. Konfigurasi preset akan digabung dengan pengaturan Anda saat ini; nilai dari preset akan menimpa field yang sama.
Simpan Penugasan
Klik tombol Buat Penugasan (mode tambah) atau Perbarui Penugasan (mode perbarui) di bagian bawah halaman.
Sistem akan:
- Memvalidasi bahwa analitik sudah dipilih
- Membangun objek konfigurasi Pipeline dari area, logika, dan parameter kustom
- Memanggil API untuk menyimpan atau memperbarui Pipeline
- Mengarahkan Anda kembali ke halaman detail stream dengan analitik yang baru di-assign sudah terpilih
Jika terjadi kesalahan, pesan error akan muncul sebagai notifikasi. Anda dapat mencoba ulang tanpa kehilangan konfigurasi yang sudah diisi.
Fitur Utama
Multi-Logika per Analitik
Analitik People Analytics dan Vehicle Analytics mendukung beberapa logika sekaligus (counting, dwelling, density, speed) dalam satu stream — setiap logika berjalan sebagai sub-analitik independen.
Drawing Preset
Simpan konfigurasi ROI sebagai preset bernama dan muat ulang kapan saja — mengurangi waktu konfigurasi untuk kamera dengan layout yang sama.
Kalibrasi Bidang (Speed)
Masukkan dimensi nyata area pemantauan dalam meter untuk mengaktifkan estimasi kecepatan objek yang akurat pada logika speed.
Preset Konfigurasi
Muat pengaturan analitik yang telah dikonfigurasi sebelumnya (preset) untuk memulai konfigurasi lebih cepat pada skenario umum.
Konfigurasi JSON Lanjutan
Editor JSON dengan validasi real-time untuk memasukkan parameter analitik secara bebas, melampaui batasan form sederhana.
ROI Whitelist / Blacklist (FR)
Untuk Face Recognition, setiap poligon area dapat ditandai sebagai whitelist atau blacklist untuk mengontrol jenis matching yang berlaku di area tersebut.
API Reference
Dokumentasi lengkap seluruh endpoint Assignment — Pipeline CRUD, template konfigurasi, preset konfigurasi, dan drawing preset — tersedia di halaman API Reference.