Playback Rekaman
Putar ulang rekaman kamera per segmen dari Media Server — pilih waktu, telusuri daftar rekaman, unduh footage, dan akses stream Playback melalui API untuk investigasi forensik.
Pengenalan
Halaman Playback Rekaman (/media-servers/recorded-streams/:nvrServerId/playback) adalah antarmuka untuk memutar ulang footage kamera yang tersimpan di NVR (Network Video Recorder) Media Server. Berbeda dengan stream langsung, halaman ini menampilkan rekaman yang telah tersegmentasi berdasarkan waktu sehingga Anda dapat melompat ke momen tertentu, memutar segmen secara berurutan, dan mengunduh klip rekaman.
Halaman Playback menggabungkan video player beresolusi penuh di sisi kiri dengan daftar segmen rekaman di sisi kanan. Setiap segmen merepresentasikan satu blok rekaman berkelanjutan — biasanya berdurasi 90 detik atau sesuai konfigurasi Media Server. Sistem secara otomatis memilih segmen terbaru saat halaman pertama kali dibuka, namun Anda dapat berpindah ke segmen mana pun dengan sekali klik.
Jump-to-time dari Event: Saat Anda membuka Playback dari halaman detail event atau riwayat kejadian, sistem akan otomatis mencari dan memutar segmen yang paling dekat dengan timestamp event tersebut. Segmen terdekat akan disorot di daftar rekaman di sisi kanan, sementara video player langsung memutar dari titik waktu event yang dimaksud.
Ketersediaan Rekaman: Rekaman hanya tersedia jika kamera terdaftar dan fitur recording diaktifkan di Media Server. Jika daftar segmen kosong, pastikan Media Server berjalan normal dan konfigurasi retensi rekaman sudah diatur dengan benar.
Cara Menggunakan
Memutar Rekaman
Buka halaman Playback
Navigasikan ke Media Servers → Recorded Streams, lalu pilih rekaman yang ingin Anda tinjau. Sistem akan membuka halaman Playback dan secara otomatis memilih segmen rekaman terbaru untuk diputar. Informasi tanggal dan waktu segmen yang sedang aktif ditampilkan di kartu Tanggal Rekaman di bagian atas halaman.
Pilih segmen rekaman
Di panel Daftar Segmen sebelah kanan video player, Anda akan melihat daftar segmen rekaman yang tersedia diurutkan berdasarkan waktu. Setiap entri menampilkan waktu mulai segmen dan durasinya. Klik segmen mana pun untuk langsung memutarnya — video player akan beralih ke segmen yang dipilih dan mulai memutar secara otomatis.
Segmen yang sedang aktif ditandai dengan highlight berbeda dan indikator animasi hijau. Segmen yang disorot (hasil jump-to-time dari event) juga diberi penanda terpisah meskipun belum dipilih.
Kontrol pemutaran video
Gunakan kontrol video player standar untuk mengatur pemutaran:
- Play / Pause: Tombol di tengah bawah player atau tekan
Spasi - Maju/Mundur: Klik dan seret progress bar di bawah player
- Volume: Sesuaikan dengan slider volume di kanan bawah player
- Layar Penuh: Klik ikon layar penuh di pojok kanan bawah player
Video player mendukung codec H.264 secara native di semua browser modern. Untuk rekaman dengan codec H.265/HEVC, lihat bagian Format Streaming yang Didukung.
Unduh segmen rekaman
Untuk mengunduh segmen yang sedang diputar, klik tombol Unduh di pojok kanan atas video player. File akan diunduh dalam format MP4 dengan nama file yang menyertakan informasi channel, path stream, dan timestamp rekaman.
Untuk mengunduh segmen lain tanpa harus memutarnya terlebih dahulu, klik ikon unduh yang tersedia di setiap entri pada daftar segmen di panel kanan.
Beralih ke tampilan Daily Playback
Jika Anda ingin mencari rekaman berdasarkan hari dan jam tertentu menggunakan timeline interaktif, klik tab Daily di pojok kanan atas halaman. Sistem akan berpindah ke halaman Daily Playback dengan mempertahankan konteks kamera yang sama.
Fitur Utama
Daftar Segmen Rekaman
Panel samping yang menampilkan seluruh segmen rekaman yang tersedia untuk kamera dan channel yang dipilih. Setiap segmen menampilkan waktu mulai dan durasi. Klik segmen untuk langsung memutarnya, atau gunakan tombol unduh individual untuk mengunduh tanpa memutar.
Jump-to-Time Otomatis
Saat dibuka dari halaman event atau riwayat kejadian, sistem mencocokkan timestamp event dengan segmen rekaman terdekat dan langsung memutar dari titik waktu yang relevan — tanpa perlu menelusuri daftar secara manual.
Unduh Footage Langsung
Unduh segmen rekaman aktif atau segmen mana pun dari daftar dalam satu klik. File nama dihasilkan otomatis berdasarkan channel, path stream, dan timestamp — memudahkan pengelolaan berkas bukti forensik.
Informasi Stream Real-time
Kartu informasi di bagian atas menampilkan nama kamera, status online/offline, lokasi (site dan koordinat), serta jumlah segmen yang tersedia. Klik kartu kamera untuk membuka halaman detail stream terkait.
API Reference
Halaman Playback menggunakan dua kelompok endpoint: endpoint internal Lenz Dashboard untuk mengambil metadata segmen, dan endpoint langsung ke NVR Media Server untuk streaming video dan unduhan.
Endpoint Daftar Segmen
Mengambil daftar segmen rekaman yang tersedia untuk channel dan path stream tertentu.
GET /api/visionaire-media/{nvrServerId}/playbacks/{channel}/{path}Path Parameters
Prop
Type
Query Parameters
Prop
Type
Contoh Respons
{
"success": true,
"data": [
{
"start": "2025-04-29T08:00:00Z",
"duration": 90,
"url": "http://nvr-host:9080/api/v1/playbacks/live/camera_front?start=2025-04-29T08:00:00Z&duration=90"
},
{
"start": "2025-04-29T08:01:30Z",
"duration": 90,
"url": "http://nvr-host:9080/api/v1/playbacks/live/camera_front?start=2025-04-29T08:01:30Z&duration=90"
}
]
}Endpoint Stream Playback (Langsung ke NVR)
Endpoint ini diakses langsung dari browser ke NVR Media Server, bukan melalui Lenz Dashboard API. Digunakan untuk streaming video dan unduhan footage.
Stream Video (HLS/TS)
GET http://{nvrHost}:{apiPort}/api/v1/playbacks/{channel}/{path}
?start={timestamp}&duration={detik}Query Parameters
Prop
Type
Contoh URL Streaming
http://192.168.1.100:9080/api/v1/playbacks/live/camera_front?start=2025-04-29T08:00:00Z&duration=90Contoh URL Download
http://192.168.1.100:9080/api/v1/playbacks/live/camera_front?start=2025-04-29T08:00:00Z&duration=90&transcode=true&download=trueEndpoint Informasi NVR Server
Digunakan untuk mengambil host dan api_port NVR Server guna mengkonstruksi URL streaming secara dinamis.
GET /api/nvr-servers/{nvrServerId}Contoh Respons (sebagian)
{
"success": true,
"data": {
"id": 1,
"name": "NVR Gedung A",
"host": "http://192.168.1.100",
"api_port": "9080",
"playback_port": "9080"
}
}Format Streaming yang Didukung
| Format | Keterangan | Dukungan Browser |
|---|---|---|
| HLS (HTTP Live Streaming) | Format utama yang digunakan untuk Playback. Video disampaikan melalui HTTP dalam segmen .ts. | Semua browser modern (Chrome, Firefox, Edge, Safari) |
| H.264 / AVC | Codec video standar, didukung secara native oleh seluruh browser. | Penuh |
| H.265 / HEVC | Codec efisiensi tinggi. Tidak didukung secara native di sebagian besar browser. Gunakan parameter transcode=true pada URL Playback untuk konversi otomatis ke H.264, atau salin URL video dan putar di aplikasi media player eksternal (VLC, mpv). | Terbatas |
| RTSP | Protokol streaming langsung dari kamera ke Media Server. Tidak dapat diputar langsung di browser — gunakan aplikasi media player atau integrasikan melalui proxy HLS. | Tidak didukung browser |
Transcoding Otomatis: Saat Lenz Dashboard mendeteksi bahwa browser tidak mendukung H.265, video player akan menampilkan opsi untuk menyalin URL video. Anda dapat membuka URL tersebut di VLC atau aplikasi media player lain yang mendukung HEVC. Alternatifnya, gunakan parameter ?transcode=true pada URL Playback untuk mengaktifkan konversi server-side ke H.264.
Tips & Troubleshooting
Selanjutnya
Daily Playback
Telusuri rekaman berdasarkan hari menggunakan kalender interaktif dan timeline per jam. Cocok untuk investigasi footage dalam rentang waktu yang lebih luas.
Recorded Streams
Lihat daftar semua stream kamera yang memiliki rekaman di NVR Server. Titik masuk untuk mengakses Playback maupun Daily Playback per kamera.
Recorded Streams
Lihat daftar stream yang sedang atau sudah direkam di Media Server — pilih stream untuk playback, filter berdasarkan channel, dan kelola rekaman langsung dari satu halaman.
Daily Playback
Tampilkan dan putar rekaman satu hari penuh dalam tampilan Timeline harian — identifikasi aktivitas dengan cepat tanpa harus membuka segmen per segmen.