CSS menyediakan fitur campuran streaming langsung. Fitur ini dapat mencampurkan secara bersamaan beberapa streaming sumber input menjadi satu streaming baru berdasarkan tata letak campuran streaming terkonfigurasi untuk streaming langsung interaktif. Selain itu, fitur campuran streaming telah terkoneksi dengan TencentCloud API 3.0. Informasi selengkapnya dapat dilihat di CreateCommonMixStream. Dokumen ini menggunakan contoh untuk menjelaskan cara mengimplementasikan campuran streaming langsung dalam berbagai skenario.
Untuk menggunakan fitur pencampuran dan pemotongan, nilai parameter pemotongan tidak boleh melebihi nilai parameter streaming input.
Fitur yang Didukung
Pencampuran dapat dilakukan pada maksimum 16 streaming bersamaan.
Pencampuran dapat dilakukan pada maksimum 5 jenis sumber input (audio dan video, audio murni, video murni, gambar, dan kanvas).
Streaming campuran dapat menjadi output sebagai streaming baru.
Pemotongan dan pemberian watermark didukung.
Konfigurasi templat didukung.
Perekaman berdasarkan campuran streaming didukung.
Campuran streaming otomatis didukung.
Jenis dan posisi campuran streaming dapat diubah secara real-time.
Campuran streaming dapat dimulai/dibatalkan dengan lancar.
Templat Tata Letak Umum
Templat umum meliputi 10, 30, 40, 310, 390, 410, 510, dan 610. Ketika menggunakan templat umum, Anda tidak perlu memasukkan parameter posisi dan panjang/lebar streaming input, dan skala gambar asli akan diatur secara otomatis. Anda hanya perlu memasukkan ID templat.
Gunakan tata letak kustom, dengan parameter posisi LocationX dan LocationY menunjukkan jarak piksel absolut antara sudut kiri atas citra kecil dan sudut kiri atas gambar latar belakang.
Setelah mengajukan pembatalan campuran streaming, tunggu setidaknya selama 5 detik sebelum membatalkannya.
Setelah membatalkan campuran streaming, Anda dapat mengajukan campuran streaming menggunakan ID sesi yang sama setelah menunggu setidaknya selama setengah menit sebelum.
Kode Kesalahan
Untuk campuran streaming API 3.0, kode-kode kesalahan paling umum telah ditransformasikan menjadi gaya kode kesalahan API 3.0. Namun, beberapa kode kesalahan masih belum berubah, yang akan tersedia dalam format err_code [ $code ],msg [ $message ] di Message (Pesan) dan di-prompt sebagai kesalahan InvalidParameter. Penyebab ditampilkannya kode tertentu dijelaskan di bawah ini:
Kode Kesalahan
Alasan
Pemecahan Masalah
-1
Terjadi kesalahan ketika menguraikan parameter input
Periksa format JSON isi permintaan sudah benar atau belum.
Periksa kemungkinan `InputStreamList` kosong.
-2
Parameter input salah
Periksa kemungkinan parameter gambar terlalu besar.
-3
Jumlah streaming salah
Periksa jumlah streaming input berada dalam rentang [1,16] atau tidak.
-4
Parameter streaming salah
Periksa panjang/lebar streaming input/output berada dalam rentang (0,3000) atau tidak.
Periksa jumlah streaming input berada dalam rentang (0,16] atau tidak.
Periksa streaming input membawa `LayoutParams` atau tidak.
Periksa `InputType` didukung atau tidak (nilai valid: 0, 2, 3, 4, 5).
Periksa panjang ID streaming berada dalam rentang (1,80) atau tidak.
-11
Kesalahan lapisan
Periksa jumlah lapisan sama dengan jumlah streaming input atau tidak.
Periksa ID lapisan merupakan duplikat atau bukan.
Periksa ID lapisan berada dalam rentang (0,16] atau tidak.
-20
Parameter input tidak sesuai dengan API
Periksa jumlah streaming input sesuai dengan ID templat atau tidak.
Periksa parameter warna benar atau tidak.
-21
Jumlah streaming input untuk campuran streaming salah
Periksa ada sedikitnya dua streaming input atau tidak.
-28
Gagal mendapatkan panjang/lebar latar belakang
Periksa panjang dan lebar kanvas sudah diatur atau belum ketika mengatur kanvas.
Periksa streaming latar belakang sudah ada atau belum (campuran streaming harus dimulai 5 detik setelah push dimulai).
-29
Parameter pemotongan salah
Periksa posisi pemotongan berada di luar rentang panjang/lebar streaming atau tidak.
-33
ID gambar watermark salah
Periksa ID gambar input sudah diatur atau belum.
-34
Gagal mendapatkan URL gambar watermark
Periksa gambar berhasil diunggah atau tidak dan URL sudah dibuat atau belum.
-111
Parameter `OutputStreamName` tidak sesuai dengan `OutputStreamType`
Jika `OutputStreamType` diatur ke `0`, `OutputStreamName` harus berada dalam `InputStreamList`.
Jika `OutputStreamType` diatur ke `1`, `OutputStreamName` tidak boleh berada dalam `InputStreamList`.
-300
ID streaming output sudah digunakan
Periksa streaming output saat ini termasuk dalam tugas campuran streaming.lain atau tidak
-505
Gagal menemukan streaming input dalam `upload`
Periksa campuran streaming dimulai 5 detik setelah push atau tidak dan streaming dapat diputar ulang atau tidak.
-507
Gagal mengajukan kueri tentang parameter panjang/lebar streaming
Periksa panjang dan lebar kanvas sudah diatur atau tidak.
Periksa push berhasil atau tidak. Anda sebaiknya memulai campuran streaming 5 detik setelah push dimulai.
-508
ID streaming output salah
Periksa kemungkinan ID streaming output yang berbeda digunakan oleh `MixStreamSessionId` yang sama.
-10031
Gagal memicu campuran streaming
Anda sebaiknya memulai campuran streaming 5 detik setelah push dimulai.
-30300-31001-31002
`Sessionid` tidak ada ketika campuran streaming dibatalkan
Periksa `MixStreamSessionId` ada atau tidak.
-31003
ID streaming output tidak sesuai dengan ID streaming di `session`
Periksa ID streaming output yang dimasukkan ketika campuran streaming dibatalkan.
-31004
Bitrate streaming output tidak valid
Periksa bitrate streaming output berada dalam rentang [1.50000] atau tidak.
