ApsaraVideo Live：StartLiveMPUTask

Secara default, Anda dapat membuat hingga 200 tugas relay aliran tunggal dan hingga 40 tugas relay aliran campuran untuk satu aplikasi. Untuk menambah kuota, kirim tiket.

Siklus hidup tugas relay aliran

Mulai

• Panggil operasi StartLiveMPUTask untuk membuat tugas.

  • Jika tidak ada pengguna yang bergabung ke saluran, sistem akan mengembalikan error yang menunjukkan bahwa saluran tidak ada.

  • Relay aliran tidak dilakukan jika tidak ada aliran yang diingest. Dalam kasus ini, tidak tersedia aliran relay untuk diputar.

  • Jika tugas berada dalam mode relay aliran campuran, pastikan setidaknya satu pengguna mengingest aliran yang dapat direlay untuk diputar. Layar hitam ditampilkan di panel pengguna yang tidak mengingest aliran.

• Kami menyarankan agar Anda mencatat status tugas, mode tugas, dan parameter tugas di server bisnis Anda.

  • Status tugas: dimulai atau dihentikan.

  • Mode tugas: relay aliran tunggal atau relay aliran campuran.

  • Parameter tugas: parameter input terbaru. Misalnya, setelah panggilan operasi UpdateLiveMPUTask berhasil, catat parameter tugas tersebut sebagai yang terbaru.

• Dalam skenario co-streaming atau battle, tugas berada dalam mode relay aliran campuran. Jika streamer meninggalkan saluran karena pengecualian dan kembali bergabung ke saluran, Anda dapat langsung memanggil operasi StartLiveMPUTask di server bisnis Anda untuk memulai relay aliran berdasarkan parameter tugas yang telah dicatat.

  • Jika tugas belum secara otomatis dihapus oleh sistem, tugas akan langsung dimulai.

  • Jika tugas sudah ada, sistem akan mengembalikan pesan yang menunjukkan bahwa tugas sudah ada.

Akhir

• Setelah streamer meninggalkan saluran, Anda perlu memanggil operasi StopLiveMPUTask untuk menghentikan tugas.

• Jika semua pengguna yang ditentukan dalam tugas telah meninggalkan saluran tetapi Anda tidak memanggil operasi StopLiveMPUTask, sistem akan menghentikan tugas dalam waktu 2 menit.

Batas QPS

Anda dapat memanggil operasi ini hingga 500 kali per detik per akun. Permintaan yang melebihi batas ini akan dibuang dan dapat menyebabkan gangguan layanan. Kami menyarankan agar Anda memperhatikan batas ini saat memanggil operasi ini.

SEI Tata Letak dan Volume

Catatan Data streaming dari aliran relay berisi SEI, yang dapat digunakan untuk menyampaikan informasi kustom. SEI dapat diekstraksi dari data frame video selama decoding. Untuk informasi tentang format SEI, lihat deskripsi parameter PassThrough di bagian Parameter Permintaan.

Contoh berikut menunjukkan skenario co-streaming:

Jika satu streamer melakukan streaming, pesan SEI yang diterima pemirsa hanya berisi informasi tentang satu peserta. Jika terjadi co-streaming atau battle, pesan SEI yang diterima pemirsa berisi informasi tentang beberapa peserta. Misalnya, ketika streamer dengan ID pengguna 111 melakukan streaming, frame SEI dalam format berikut dikirim ke sisi pemirsa:
{"canvas":{"w":1920,"h":1080,"bgnd":0},"stream":[{"uid":"111","paneid":-1,"zorder":0,"x":0,"y":0,"w":0,"h":0,"type":0,"status":1,"muted":0,"vol":0,"vad":0}],"ver":"1.0.0.20220915","ts":1697696105170} Ketika streamer dengan ID pengguna 111 melakukan co-streaming dengan co-streamer yang memiliki ID pengguna 222, frame SEI dalam format berikut dikirim ke sisi pemirsa:
{"canvas":{"w":1920,"h":1080,"bgnd":0},"stream":[{"uid":"111","paneid":0,"zorder":1,"x":0,"y":0.25,"w":0.5,"h":0.5,"type":0,"status":1,"muted":0,"vol":1,"vad":119},{"uid":"222","paneid":1,"zorder":1,"x":0.5018382,"y":0.25,"w":0.5,"h":0.5,"type":0,"status":1,"muted":0,"vol":60,"vad":123}],"ver":"1.0.0.20220915","ts":1697696106230} Pemirsa dapat menentukan apakah tata letak streaming berubah berdasarkan jumlah elemen dalam array stream. Jika hanya ada satu elemen dalam array stream, berarti hanya satu streamer yang melakukan streaming. Jika terdapat lebih dari satu elemen dalam array stream, berarti sedang terjadi co-streaming atau battle. Informasi tata letak peserta menunjukkan posisi masing-masing peserta dalam aliran campuran.

Pass-through SEI

• Untuk mengonfigurasi SEI kustom, panggil operasi StartLiveMPUTask untuk memulai tugas relay aliran campuran dan tentukan parameter PayloadContent di bawah parameter PassThrough, atau panggil operasi UpdateLiveMPUTask untuk memperbarui tugas relay aliran campuran dan tentukan parameter PayloadContent di bawah parameter PassThrough.

• SEI kustom dapat dikirim secara berkala. Anda dapat menggunakan parameter Interval di bawah parameter PassThrough untuk menentukan interval dalam milidetik.

• SEI kustom juga dapat dikirim bersama keyframe dengan menentukan parameter FollowIdr di bawah parameter PassThrough.

  • Anda dapat mengonfigurasi pengiriman SEI kustom secara berkala dan mengirim SEI kustom bersama keyframe secara bersamaan. Misalnya, Anda dapat mengatur parameter Interval ke 1000 dan parameter FollowIdr ke 1 untuk mengirim SEI kustom setiap 1.000 milidetik dan menyertakan SEI kustom dalam keyframe.

  • Jika Anda tidak menentukan parameter Interval dan parameter FollowIdr, SEI kustom hanya dikirim sekali saat Anda memanggil operasi tersebut.

Misalnya, streamer dengan ID pengguna 111 mengingest aliran dan memanggil operasi UpdateLiveMPUTask untuk menentukan SEI berkala. Dalam operasi tersebut, parameter Interval diatur ke 1000, parameter FollowIdr diatur ke 0, dan parameter PayloadContent diatur ke "hello world". Dalam kasus ini, SEI kustom dikirim setiap 1.000 milidetik. Frame SEI yang diterima di sisi pemirsa dalam format berikut:
{"canvas":{"w":1920,"h":1080,"bgnd":0},"stream":[{"uid":"111","paneid":-1,"zorder":0,"x":0,"y":0,"w":0,"h":0,"type":0,"status":1,"muted":0,"vol":0,"vad":0}],"ver":"1.0.0.20220915","ts":1697696109876,"udd":"hello world"}

Relay aliran campuran lintas saluran

Jika Anda ingin mencampur aliran dari beberapa streamer di beberapa saluran dan merelay aliran campuran tersebut ke ApsaraVideo Live, Anda harus menentukan ID pengguna dan ID saluran streamer yang memulai panggilan lintas saluran serta ID pengguna streamer lainnya sebagai parameter input untuk membuat tugas relay aliran campuran. Contoh: Dalam skenario battle, Streamer A di Saluran A memulai battle lintas saluran dengan Streamer B di Saluran B menggunakan antarmuka klien dan merelay aliran campuran tersebut kepada pemirsa di Saluran A. Dalam contoh ini, parameter berikut ditentukan:

• ChannelID: channelA

• UserId di bawah UserInfos: userA dan userB

Catatan Untuk membuat tugas relay aliran campuran lintas saluran, pastikan panggilan lintas saluran telah dimulai menggunakan SDK di sisi klien. Jika pengguna di saluran berbeda tidak saling melakukan panggilan, Anda tidak dapat membuat tugas relay aliran campuran lintas saluran. Untuk informasi lebih lanjut tentang cara memulai panggilan lintas saluran, lihat Cross-channel subscription.