Video Analysis
Unggah file video rekaman dan jalankan analitik AI secara offline — untuk investigasi dan audit dari rekaman yang ada di luar NVR.
Pengenalan
Video Analysis adalah fitur analitik offline di Lenz Dashboard — berbeda dari pemantauan stream real-time yang memproses feed CCTV secara langsung. Fitur ini dirancang untuk situasi di mana Anda memiliki rekaman video yang sudah ada (dari kamera portabel, dashcam, perangkat seluler, atau NVR eksternal) dan ingin menerapkan analitik AI seperti Face Recognition (FR) atau License Plate Recognition (LPR) terhadap rekaman tersebut.
Alur kerjanya sederhana: Anda mengunggah file video, memilih jenis analitik yang diinginkan, lalu sistem memproses video di latar belakang. Hasilnya berupa daftar Job yang dapat Anda pantau progresnya, serta event-event yang ditemukan tersedia di Event History setelah analisis selesai.
Video Analysis memproses rekaman secara asinkron. Anda tidak perlu menunggu di halaman — sistem akan terus bekerja di latar belakang dan Anda dapat memantau progres kapan saja.
Fitur ini memerlukan konfigurasi System Media Server terlebih dahulu. Jika halaman menampilkan pesan "System Media Server Belum Dikonfigurasi", ikuti panduan di bagian Prasyarat di bawah.
Kapan Menggunakan Video Analysis?
- Anda memiliki rekaman dari kamera yang tidak terhubung langsung ke Visionaire
- Anda perlu menganalisis footage dari peristiwa yang sudah terjadi
- Anda melakukan audit atau investigasi forensik berbasis rekaman
- Anda ingin menguji analitik AI terhadap video sampel sebelum deployment kamera
Prasyarat
Sebelum menggunakan Video Analysis, pastikan:
- Buka Configuration > Preference di sidebar
- Aktifkan opsi "Offline Analysis" di bagian Feature
- Atur System Media Server di bagian Offline Analysis — pilih media server yang akan dipakai sebagai backend pemrosesan video
- Jika belum ada media server, daftarkan terlebih dahulu di halaman Media Servers
Pengaturan ini hanya perlu dilakukan sekali oleh administrator. Setelah dikonfigurasi, semua pengguna yang memiliki permission VIDEO_MANAGEMENT dapat menggunakan fitur ini.
Cara Menggunakan
Upload dan Jalankan Analisis
Buka halaman Video Analysis
Akses /video-analysis dari sidebar Lenz Dashboard. Anda akan melihat area Upload di bagian atas dan tabel daftar Job di bawahnya.
Upload file video
Seret file video ke area Upload, atau klik area tersebut untuk membuka file picker. Sistem mendukung upload file besar dengan mekanisme chunked upload — file dipotong menjadi beberapa bagian dan dikirim secara bertahap, sehingga upload dapat dilanjutkan jika koneksi terputus.
Setelah file dipilih, proses upload akan dimulai otomatis. Anda dapat memantau progres upload secara real-time melalui progress bar yang ditampilkan.
Jika upload terputus di tengah jalan (misalnya koneksi mati), sistem mendukung resume upload — unggah ulang file yang sama dan sistem akan melanjutkan dari bagian yang belum dikirim menggunakan session_id yang tersimpan.
Pilih Analytic
Setelah upload selesai, video akan muncul di tabel daftar Job. Klik tombol Mulai Analisa atau Tambah Analisa di baris video yang bersangkutan untuk memilih jenis analitik:
- Face Recognition (FR) — deteksi dan pengenalan wajah
- License Plate Recognition (LPR) — pembacaan plat nomor kendaraan
- Analitik lain yang tersedia di instance Visionaire Anda
Anda dapat menambahkan lebih dari satu analitik ke satu video.
Mulai analisis
Klik Assign atau Mulai Analisa untuk memulai pemrosesan. Sistem akan membuat stream internal dari video yang diunggah dan mulai menjalankan pipeline analitik yang dipilih.
Status Job akan berubah menjadi Menginisialisasi kemudian Berjalan.
Pantau progres
Di tabel, kolom Status menampilkan progres analisis secara real-time:
| Status | Arti |
|---|---|
| Menunggu | Antri, belum dimulai |
| Menginisialisasi | Sistem mempersiapkan pipeline |
| Berjalan | Analisis sedang berlangsung |
| Selesai | Analisis selesai, hasil tersedia |
| Terjadwal | Dijadwalkan untuk dimulai nanti |
| Error | Terjadi kesalahan saat analisis |
Untuk video berdurasi panjang, sistem membagi video menjadi beberapa chunk dan memprosesnya secara paralel. Anda dapat melihat ringkasan per-chunk (misalnya: "2 Sukses, 1 Proses, 0 Error") langsung di kolom status.
Lihat hasil analisis
Klik nama file atau ikon Lihat Detail pada baris video untuk membuka halaman detail Job (/video-analysis/:id).
Halaman detail menampilkan:
- Live Inference — tampilan real-time dari chunk yang sedang diproses (hanya muncul saat analisis berjalan)
- Pemutar Video — playback rekaman dengan navigasi berbasis timeline
- Statistik — ringkasan jumlah deteksi, grafik per analitik yang dipilih
- Timeline — navigasi berbasis waktu untuk menemukan segmen tertentu
Untuk menelusuri semua event yang ditemukan, klik ikon Buka Event History di pojok timeline — ini akan membuka Event History dengan filter otomatis ke stream dan rentang waktu video tersebut.
Fitur Utama
Chunked Upload dengan Resume
File besar diunggah dalam potongan-potongan kecil. Jika koneksi terputus, upload dapat dilanjutkan tanpa mengulang dari awal.
Multi-Analitik per Video
Satu video dapat dianalisis oleh lebih dari satu analitik secara bersamaan — misalnya FR dan LPR sekaligus.
Chunk Progress Tracking
Video panjang dibagi menjadi beberapa chunk dan diproses paralel. Status setiap chunk ditampilkan secara individual.
Live Inference View
Selama analisis berjalan, Anda dapat melihat tampilan real-time dari frame yang sedang diproses oleh model AI.
Playback Terintegrasi
Putar ulang rekaman langsung dari halaman detail dengan navigasi timeline untuk menemukan momen tertentu.
Integrasi Event History
Semua event yang ditemukan langsung tersedia di Event History dengan filter waktu dan stream otomatis.
Format Video yang Didukung
Format berikut didukung oleh sistem (bergantung pada codec yang tersedia di Media Server):
- MP4 (H.264, H.265) — format yang paling direkomendasikan
- MKV (Matroska Video)
- AVI (Audio Video Interleave)
- MOV (QuickTime Movie)
- M4V
- WebM (VP8, VP9)
- FLV (Flash Video)
- TS / MTS (MPEG Transport Stream — umum dari kamera dashcam)
- 3GP / 3G2 (format mobile)
Codec video yang direkomendasikan adalah H.264 (AVC). File dengan codec H.265 (HEVC) didukung tetapi dapat memerlukan waktu pemrosesan lebih lama tergantung kapasitas server.
Tips & Troubleshooting
Selanjutnya
Streams
Pantau stream video CCTV secara real-time dengan overlay deteksi AI langsung dari Visionaire.
Event History
Telusuri semua event yang ditemukan dari analisis video, dengan filter waktu, tipe analitik, dan stream.
Face Search
Cari wajah tertentu di seluruh riwayat event menggunakan gambar atau nama sebagai query.
API Reference
Dokumentasi lengkap seluruh endpoint yang digunakan fitur Video Analysis — upload chunk, manajemen Job, katalog analitik, assignment pipeline, dan konfigurasi.
API Reference — Video Management
Endpoint untuk mengelola video yang diunggah ke Media Server — upload chunked, kontrol streaming, operasi CRUD, dan ekstraksi timestamp berbasis AI.
API Reference — Video Analysis
Endpoint untuk upload video rekaman, manajemen Job analisis offline, assign analitik, dan konfigurasi pipeline.