API Audio NVR mendukung transmisi suara via HTTP POST dengan G.711 μ-law, multi channel, prioritas, dan kontrol izin pengguna.
API Audio NVR Profesional
Dalam sistem surveillance modern, video saja sering kali belum cukup. Banyak instalasi keamanan membutuhkan komunikasi dua arah, pengumuman suara, interkom, atau peringatan langsung melalui speaker kamera. Karena itu NVR modern menyediakan API Audio Transmission yang memungkinkan pengiriman data suara ke perangkat kamera melalui jaringan.
Fitur ini sangat berguna untuk gedung perkantoran, parkiran, kawasan industri, rumah sakit, sekolah, dan smart city yang membutuhkan komunikasi real-time dari ruang kontrol ke lapangan.
Apa Itu Transmisi Audio NVR
Transmisi audio adalah proses mengirim suara dari operator ke NVR, lalu diteruskan ke kamera IP atau perangkat audio yang mendukung speaker. Sistem ini memungkinkan petugas berbicara langsung ke area kamera.
Contoh penggunaan:
Security memberi peringatan ke pengunjung parkir liar.
Operator memanggil tamu di gerbang masuk.
Control room memberi instruksi ke petugas lapangan.
Otentikasi dan Hak Akses
Untuk mengirim audio ke NVR, sistem memerlukan autentikasi HTTP Basic atau HTTP Digest. Selain login berhasil, pengguna juga wajib memiliki izin mengontrol kamera.
Artinya tidak semua user dapat mengirim suara. Ini penting agar speaker lapangan tidak disalahgunakan.
Contoh hak akses:
Administrator = semua channel
Supervisor = beberapa area
Operator = channel tertentu
Viewer = tanpa audio transmit
Endpoint HTTP Audio
Gunakan metode POST ke jalur berikut:
POST /api/transmit HTTP/1.1
Content-Type: audio/basic
Transfer-Encoding: chunked
Server menerima stream audio yang dikirim secara bertahap menggunakan chunked transfer encoding.
Format Audio yang Digunakan
NVR menggunakan kompresi:
G.711 μ-law
Format ini populer pada sistem telephony dan CCTV karena:
Latency rendah
Ringan bandwidth
Stabil real-time
Kompatibel perangkat surveillance
Parameter API Audio
Beberapa parameter yang dapat digunakan:
channels = nomor channel kamera
priority = prioritas audio
live = mode audio langsung
Contoh:
channels=1
channels=1,3-4,7
priority=5
live=true
Penjelasan:
channels dimulai dari angka 1
Bisa banyak channel sekaligus
Semakin tinggi priority maka lebih diutamakan
live=true untuk komunikasi real-time
Contoh Implementasi
Kirim audio ke kamera 1 dan 3:
POST /api/transmit?channels=1,3&priority=2&live=true
Kirim pengumuman prioritas tinggi ke area parkir:
POST /api/transmit?channels=7&priority=9&live=true
Kode Respons HTTP
Sistem akan mengembalikan kode status untuk memudahkan troubleshooting.
400 Bad Request
Format parameter salah
401 Unauthorized
Login gagal
403 Forbidden
Tidak ada izin atau perangkat audio tidak tersedia
404 Not Found
Fitur audio tidak didukung
415 Unsupported Media Type
Format audio salah
Contoh Error 403
Jika channel 2 tidak punya izin dan channel 3 tidak punya speaker:
{
"errors": [
{
"type": "no-device",
"channels": [3]
},
{
"type": "permission-denied",
"channels": [2,3]
}
]
}
Artinya:
Channel 3 tidak memiliki perangkat audio
Channel 2 dan 3 ditolak karena permission
Manfaat API Audio NVR
Komunikasi dua arah real-time
Peringatan langsung ke lapangan
Broadcast ke beberapa kamera
Kontrol terpusat dari command center
Integrasi dengan access control dan alarm
Studi Kasus Profesional
Mall menggunakan speaker kamera untuk mengatur parkir.
Pabrik memberi instruksi keselamatan area produksi.
Sekolah menggunakan interkom gerbang utama.
Smart city memberi peringatan area publik.
Tips Implementasi
Gunakan jaringan stabil
Pastikan kamera memiliki speaker
Pisahkan hak akses user
Gunakan priority tinggi untuk alarm penting
Test latency audio secara berkala
Kesimpulan
API Audio NVR menghadirkan fungsi komunikasi modern dalam sistem surveillance. Dengan dukungan HTTP POST, G.711 μ-law, multi channel, prioritas audio, dan kontrol permission, operator dapat berkomunikasi langsung ke area pengawasan secara aman dan efisien. Solusi ini menjadikan CCTV bukan hanya alat pantau, tetapi juga sarana kendali aktif bersama Nextid.