Live Streaming

Pengenalan

Setiap device yang active dipublish sebagai stream {channel}/{name}. Liodra lalu menyajikannya ulang ke banyak penonton sekaligus tanpa membebani kamera. Ada dua arah lalu lintas live:

• Keluar (play): Visionaire, VLC, browser, atau sistem lain menarik stream dari Liodra.
• Masuk (publish): encoder, aplikasi mobile, atau drone mem-publish RTMP langsung ke Liodra tanpa perlu didaftarkan sebagai device (Liodra hanya menjadi penerima; stream tetap direkam bila berada di channel yang merekam).

Cara Menggunakan

rtsp://<host-liodra>:8554/live/camera_front

<video id="player" controls muted autoplay></video>
<script src="https://cdn.jsdelivr.net/npm/mpegts.js@1.7.3/dist/mpegts.js"></script>
<script>
  const player = mpegts.createPlayer({
    type: "mpegts",
    isLive: true,
    url: "http://<host-liodra>:9080/api/v1/play/ts/live/camera_front?transcode=true",
  });
  player.attachMediaElement(document.getElementById("player"));
  player.load();
  player.play();
</script>

curl -X POST http://localhost:9080/api/v1/register \
  -H 'Content-Type: application/json' \
  -d '{ "device_name": "drone_01", "channel": "live/drone" }'

{
  "success": true,
  "data": {
    "device_name": "drone_01",
    "channel": "live/drone",
    "rtmp_url": "rtmp://127.0.0.1:1935/live/drone/drone_01?token=3f9a1c..."
  }
}

ffmpeg -re -i input.mp4 -c copy -f flv \
  "rtmp://<host-liodra>:1935/live/drone/drone_01?token=3f9a1c..."

Fitur Utama

Proxy HTTP-TS dengan transcode on-demand

GET /api/v1/play/ts/{path} adalah pintu masuk yang dipakai Lenz. Tanpa transcode, Liodra hanya meneruskan byte stream (menambahkan .ts dan ?vhost= bila perlu). Dengan transcode=true, Liodra memeriksa codec stream: H.264 tetap diproksi langsung, HEVC di-transcode ke H.264 dengan encoder hardware bila tersedia, atau encoder software bila tidak.

Setiap penonton HEVC memakai satu proses transcode. Batasnya MAX_ONDEMAND_PROCESSES (32); di atasnya Liodra menjawab 503 dengan header Retry-After: 5. Proses yang penontonnya pergi dihentikan otomatis dan bisa dilihat di GET /api/v1/monitor/ondemand.

Otentikasi RTMP

Secara default siapa pun yang bisa mencapai port 1935 dapat publish atau play. Set RTMP_SECRET untuk mewajibkan token:

1. Klien memanggil POST /api/v1/register dengan device_name dan channel (keduanya harus cocok ^[a-z0-9][a-z0-9_-]*$, channel boleh bertingkat dengan /). Liodra menolak 409 bila stream tersebut sedang dipublish orang lain.
2. Liodra menurunkan token (32 karakter hex) dari RTMP_SECRET dan {channel}/{device_name}, lalu mengembalikan rtmp_url yang sudah berisi ?token=.
3. Setiap publish dan play divalidasi terhadap token tersebut; koneksi tanpa token atau dengan token yang salah ditolak dan dicatat di log sebagai RTMP auth denied.
4. Play dari dalam container sendiri selalu diizinkan agar HTTP-TS, proxy /play/ts, dan DVR tetap berjalan tanpa token. Play dari host lain (termasuk RTSP di 8554) memerlukan ?token=.

Token bersifat deterministik untuk pasangan channel/device_name yang sama dan tidak berubah selama RTMP_SECRET tidak diganti, sehingga cukup didaftarkan sekali per perangkat. Device internal (dibuat lewat /api/v1/devices) otomatis menyertakan token saat publish.

Daftar stream dan klien

• GET /api/v1/streams merangkum stream yang sedang dipublish beserta codec dan jumlah penonton.
• GET /api/v1/clients menampilkan semua koneksi aktif (publisher maupun player), dengan IP, tipe, bitrate 30 detik terakhir, dan device bila koneksi tersebut milik device Liodra.
• DELETE /api/v1/clients/{id} memutus satu koneksi, misalnya untuk menendang penonton yang tidak sah atau publisher yang menggantung.

Latensi

Penonton HTTP-TS baru menerima buffer 3 detik terlebih dahulu agar pemutar cepat mulai, dengan konsekuensi tertinggal sekitar 3 detik dari live. RTSP dan RTMP mendekati latensi jaringan ditambah GOP kamera.

API Reference

Detail lengkap di API Reference: Live Streaming.

Tips & Troubleshooting

Selanjutnya