Perekaman langsung menyimpan file yang sudah dibuat dengan melakukan muxing pada streaming asal (tanpa memodifikasi informasi, seperti data audio dan video serta stempel waktu yang sesuai) di platform VOD.
Catatan
Anda dapat menggunakan salah satu metode berikut untuk merekam: membuat tugas perekaman atau membuat templat perekaman. Jika Anda membuat templat perekaman serta tugas perekaman untuk satu streaming langsung yang sama, perekaman akan dilakukan secara berulang.
Karena terjadi penundaan singkat dalam memulai tugas perekaman setelah push dilakukan pada streaming, push yang sangat singkat tidak dapat menghasilkan file rekaman. Karena itu, durasi setiap push untuk perekaman sebaiknya lebih dari 10 detik.
Penyimpanan Perekaman
Karena file rekaman disimpan di platform VOD, Anda harus mengaktifkan layanan VOD terlebih dahulu.
Keterangan:
Aturan penamaan file rekaman yang dihasilkan dapat dipelajari di VodFileName.
Format Perekaman
Format file rekaman yang didukung meliputi .aac (untuk perekaman audio), .flv, .hls, dan .mp4.
Kasus Penggunaan Perekaman
Kasus Penggunaan
Deskripsi
Perekaman multilevel oleh nama domain push dan nama streaming
Anda dapat mengonfigurasikan perekaman streaming di level nama domain push dan nama streaming.
Perekaman dalam periode waktu yang ditentukan
Anda dapat memanggil API untuk mengatur waktu dimulainya dan waktu berakhirnya perekaman streaming dalam periode waktu yang ditentukan.
Perekaman real-time
Anda dapat memanggil API untuk merekam frame mana saja dalam suatu streaming secara real-time.
Perekaman audio murni
Anda dapat menggunakan format .aac untuk merekam streaming audio murni.
Mengaktifkan Perekaman untuk Semua Streaming Langsung di Nama Domain Push yang Ditetapkan
Parameter perekaman dikelola berdasarkan templat. Anda dapat membuat templat perekaman untuk berbagai skenario dan mengelola konfigurasi perekaman secara fleksibel dengan mengikatkan templat ke berbagai nama domain push dan nama streaming.
Setelah mengaktifkan VOD, Anda dapat merekam streaming langsung di nama domain push tertentu dengan dua cara:
Konsol CSS
1. Buka Feature Configuration > Live Recording (Konfigurasi Fitur > Perekaman Langsung) untuk membuat templat perekaman.
1. Panggil API CreateLiveRecordTemplate untuk mengatur sedikitnya satu format perekaman, misalnya FlvParam.
2. Panggil API CreateLiveRecordRule dengan mengatur DomainName (nama domain push) dan TemplateId (kembali ke langkah 1). Anda dapat mengosongkan bidang AppName dan StreamName untuk merekam semua streaming di nama domain yang sama.
Anda juga dapat menentukan streaming tertentu yang akan direkam.
Sebuah templat dapat diikat dengan berbagai nama domain push, aplikasi, dan streaming, tetapi satu nama domain push, aplikasi, atau streaming tidak dapat diikat dengan banyak templat. Jika Anda mengikat streaming yang sama dengan beberapa templat (kasus ini jarang terjadi), hanya templat dengan prioritas tertinggi yang akan diterapkan. Prioritas templat ditentukan sebagai berikut.
Prioritas
DomainName
AppName
StreamName
1
✓
✓
✓
2
✓
×
✓
3
✓
✓
×
4
✓
×
×
Tanda ✓ berarti nilai parameter tidak kosong dan tanda × berarti nilai parameter kosong.
Menonaktifkan Perekaman untuk Streaming Spesifik di Suatu Nama Domain Push
Jika Anda sudah mengonfigurasikan perekaman untuk suatu nama domain push, tetapi tidak perlu merekam streaming tertentu di nama domain push tersebut:
2. Buka konsol CSS atau gunakan API CreateLiveRecordRule untuk mengikat templat perekaman di atas dengan DomainName dan StreamName spesifik.
Perhatian:
Metode ini dapat diterapkan pada berbagai skenario yang tidak perlu melakukan perekaman pada beberapa streaming. Jika jumlah streaming terlalu banyak, Anda sebaiknya menggunakan nama domain push lain untuk mengelolanya karena:
Jumlah maksimum templat perekaman atau aturan perekaman yang diizinkan adalah 50.
Pengelolaan berdasarkan nama domain push memberikan fleksibilitas lebih besar karena templat perekaman dan aturan perekaman tidak akan terpengaruh meskipun bisnis Anda berubah.
Perekaman dalam Periode Waktu yang Ditentukan
Anda dapat menggunakan API untuk menentukan waktu dimulainya, waktu berakhirnya, dan parameter lain perekaman untuk streaming tertentu. Cara ini tidak sama jika dibandingkan dengan penggunaan templat perekaman prasetel dengan parameter yang sudah ditetapkan. Biasanya, API digunakan ketika tidak ada templat perekaman yang dibuat.
Dalam skenario sederhana, Anda perlu menetapkan StreamName, DomainName, AppName, dan EndTime saja.
Contoh kode berikut membuat tugas perekaman video dalam format .flv untuk pukul 08.00 hingga 10.00, tanggal 10 Agustus 2020, dengan segmen 30 menit dan file rekaman akan disimpan secara permanen.
Contoh kode input:
Anda juga dapat menentukan parameter format perekaman, jenis perekaman, dan penyimpanan.
Contoh kode berikut membuat tugas perekaman dalam format .mp4 untuk pukul 08.00 hingga 10.00, tanggal 10 Agustus 2020, dengan segmen 1 jam dan file rekaman akan disimpan secara permanen.
Untuk streaming langsung yang sama, tidak ada benturan antara tugas-tugas terjadwal atau antara tugas terjadwal dan tugas perekaman jenis lain. Dengan kata lain, periode waktu dapat bertumpang-tindih jika terdapat beberapa tugas terjadwal, dan Anda dapat memanggil API untuk membuat tugas perekaman, selain untuk mengaktifkan konfigurasi perekaman.
Anda sebaiknya membuat tugas perekaman terlebih dahulu (sebagai contoh, 1 jam sebelumnya atau pada pagi hari jika acara Anda berlangsung pada siang hari) dan mengatur waktu dimulainya tugas sedikit lebih awal daripada waktu dimulainya acara.
Perekaman Real-Time
Jika dalam proses streaming langsung Anda ingin merekam frame tertentu saat itu juga untuk membuat klip sorotan, Anda dapat memanggil API untuk mengaktifkan perekaman real-time.
Ada dua jenis campuran streaming yang ditunjukkan oleh parameter OutputStreamType:
Jika OutputStreamType diatur ke 0, streaming output berada di daftar streaming input. Artinya, tidak ada streaming baru yang akan dibuat.
Jika OutputStreamType diatur ke 1, streaming output tidak berada di daftar streaming input. Artinya, streaming baru akan dibuat.
Misalnya, streaming yang di-push adalah A dan B, sedangkan streaming campuran adalah streaming output C:
Jika OutputStreamType diatur ke 0 dan nama streaming A digunakan sebagai nama streaming output C, setelah perekaman dimulai, file rekaman streaming A (streaming campuran) dan streaming B akan dibuat. Karena nama streaming A digunakan lagi, streaming asal A tidak akan membuat file rekaman.
Jika OutputStreamType diatur ke 1, file rekaman streaming A, streaming B, dan streaming C (streaming campuran) akan dibuat setelah perekaman dimulai.
Jika hanya ingin merekam streaming campuran, Anda dapat memanggil API CreateRecordTask. Harap ingat bahwa jika OutputStreamType diatur ke 1, parameter StreamType harus diatur ke 1 ketika pemanggilan API ini dilakukan.
Perhatian:
Perekaman streaming campuran tidak mendukung streaming campuran di dalam dan di luar Tiongkok Daratan karena kesalahan file rekaman akan terjadi dan memengaruhi pemutaran ulang normal.
Perekaman dengan Penyambungan Otomatis (Perekaman Multi-Push)
Jika beberapa file rekaman dihasilkan ketika push diinterupsi beberapa kali akibat jitter jaringan, hal tersebut akan memengaruhi kontinuitas pemutaran ulang streaming langsung. Untuk mengatasi masalah ini, perekaman langsung dapat menyambungkan secara otomatis beberapa file rekaman di antara interupsi streaming pendek menjadi satu file.
Fitur ini membagi data audio dan video dengan tag #EXT-X-DISCONTINUITY dalam perekaman HLS. Akibat interupsi streaming, stempel waktu data audio dan video, codec video, codec audio, dan tingkat sampel sebelum dan sesudah pemberian tag mungkin berbeda. Pemutar perlu memuat ulang decoder agar pemutaran ulang berjalan dengan lancar. Untuk menggunakan fitur ini, pemutar harus mendukung tag #EXT-X-DISCONTINUITY. Saat ini, tag ini didukung di pemutar asli dan Safari di iOS, ExoPlayer di Android, dan pemutar HLS.js di web, tetapi tidak didukung di pemutar VLC.
Setelah fitur ini diaktifkan, Anda harus mengatur periode waktu habis penyambungan otomatis. Periode ini berlangsung hingga 30 menit. Artinya, file-file rekaman antara interupsi dengan durasi hingga 30 menit dapat disambungkan menjadi satu file HLS setelah push terakhir berakhir.
Saat ini, perekaman dengan penyambungan otomatis hanya didukung untuk format HLS. Anda dapat mengatur periode waktu habis penyambungan otomatis di Live Recording (Perekaman Langsung).
Perhatian:
Mode ini tidak mendukung streaming langsung tanpa data audio.
API ComposeMedia VOD dapat digunakan untuk menggabungkan berbagai file video. Informasi selengkapnya dapat dilihat di ComposeMedia.
Setelah pelanjutan perekaman HLS diaktifkan, panggilan balik akan terpicu hanya ketika file rekaman dihasilkan, bukan ketika streaming diinterupsi.
Mendapatkan File Rekaman
File rekaman secara otomatis disimpan di sistem VOD setelah dibuat dan dapat ditemukan melalui:
Konsol VOD
Login ke konsol VOD dan pilih Media Assets > Video Management (Aset Media > Manajemen Video) di halaman non-admin (bukan admin) untuk melihat semua file rekaman yang dibuat.
Pemberitahuan peristiwa perekaman
Alamat panggilan balik perekaman dapat diatur di konsol atau melalui panggilan API. Pemberitahuan akan dikirim ke alamat panggilan balik setelah file rekaman dibuat. Setelah itu, Anda dapat mengacu ke pemberitahuan pesan peristiwa panggilan balik perekaman untuk mengambil langkah selanjutnya.
Panggilan balik pemberitahuan peristiwa efisien, andal, dan bersifat real-time, jadi Anda sebaiknya menggunakannya untuk mendapatkan informasi file rekaman.
Kueri dengan API VOD
Anda dapat memanggil API SearchMedia VOD untuk memfilter dan melakukan kueri file rekaman.
Perhatian:
Ketika Anda memanggil API CreateRecordTask, parameter stream_param yang terbawa dalam URL push tidak akan ditampilkan dalam panggilan balik perekaman. Namun, jika Anda menggunakan metode perekaman lain, parameter tersebut akan ditampilkan dalam panggilan balik perekaman.
Catatan seputar Modifikasi Konfigurasi
Anda sebaiknya memulai ulang push dan memverifikasi konfigurasi perekaman jika melakukan modifikasi konfigurasi. Konfigurasi diterapkan dengan mengikuti aturan berikut:
Secara default, konfigurasi diterapkan dalam 10 menit.
Konfigurasi diterapkan setelah dimulainya push langsung dan tidak akan diperbarui selama proses perekaman.
Dalam skenario dengan push berlangsung untuk waktu lama (misalnya perekaman untuk pengawasan), Anda harus menginterupsi dan memulai ulang push agar konfigurasi diterapkan.
