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.
Halaman Recorded Streams tidak punya tombol yang mengarah ke sini — ikon kalender di baris tabelnya membuka Daily Playback, bukan halaman ini. Anda membuka Playback lewat URL langsung dengan parameter app dan name (lihat API Reference di bawah), misalnya dari link yang dibagikan atau dibuat oleh integrasi lain.
Jump-to-time via URL: Jika URL Playback disertai parameter start (timestamp RFC3339), sistem otomatis mencari segmen dengan waktu mulai paling dekat, menyorotnya di daftar segmen, dan langsung memutar video dari titik waktu tersebut.
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
Buka URL Playback dengan parameter app dan name yang sesuai dengan stream yang ingin Anda tinjau (lihat API Reference). Sistem akan memuat 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.
Halaman ini tidak punya tab atau tombol untuk berpindah ke Daily Playback — keduanya adalah halaman terpisah. Untuk menelusuri rekaman berdasarkan hari dan jam dengan timeline interaktif, buka Daily Playback lewat ikon kalender di halaman Recorded Streams.
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 via URL
Buka URL Playback dengan parameter start berisi timestamp — sistem mencocokkannya dengan segmen rekaman terdekat dan langsung memutar dari titik waktu tersebut, 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.