ApsaraVideo Live：StartLiveMPUTask

Secara default, setiap ID aplikasi mendukung maksimal 200 tugas ingest aliran tunggal dan 40 tugas pencampuran serta transkoding aliran. Untuk menambah kuota, kirim tiket.

Siklus hidup tugas pencampuran aliran

Mulai

• Ketika seorang streamer mulai streaming untuk pertama kalinya, Anda dapat memanggil StartLiveMPUTask untuk memulai tugas bypass.

  • Jika tidak ada pengguna di saluran, kesalahan "saluran tidak ada" dikembalikan.

  • Aliran bypass hanya di-output ketika pengguna memulai ingest aliran. Jika pengguna dalam tugas aliran tunggal tidak melakukan ingest aliran, aliran bypass tidak dapat diputar.

  • Untuk tugas pencampuran aliran, minimal satu pengguna harus melakukan ingest aliran agar aliran bypass dapat diputar. Area tata letak untuk pengguna yang tidak melakukan ingest aliran akan menampilkan Layar hitam.

• Anda dapat mencatat status tugas bypass, jenis tugas, dan parameter tugas di server bisnis Anda.

  • Status tugas: Started, Stopped.

  • Jenis tugas: Single-stream, Stream mixing.

  • Parameter tugas: Parameter input terbaru. Misalnya, setelah pemanggilan UpdateLiveMPUTask berhasil, catat parameter tugas terbaru.

• Dalam skenario co-streaming atau PK, jika tugas telah diperbarui menjadi tugas pencampuran aliran dan streamer keluar dari saluran secara tak terduga lalu kembali bergabung, server bisnis Anda dapat memanggil StartLiveMPUTask untuk memulai ulang tugas pencampuran aliran berdasarkan jenis dan parameter tugas yang tersimpan.

  • Jika sistem belum secara otomatis menghapus tugas sebelum Anda memulainya, tugas akan dimulai dengan sukses.

  • Jika sistem belum menghapus tugas, kode kesalahan Task already exists dikembalikan.

Akhir

• Ketika streamer meninggalkan saluran, panggil StopLiveMPUTask untuk menghentikan tugas bypass.

• Jika semua pengguna dalam tugas meninggalkan saluran dan StopLiveMPUTask tidak dipanggil, sistem secara otomatis menghentikan tugas bypass setelah 2 menit.

Batas QPS

Batas permintaan per detik (QPS) untuk API ini per pengguna tunggal adalah 500 panggilan/detik. Jika Anda melebihi batas ini, panggilan API akan dikenai pengendalian aliran, yang dapat memengaruhi bisnis Anda. Kami menyarankan agar Anda memanggil API ini secara wajar.

Layout and volume SEI

Contoh untuk skenario co-streaming:

Jika hanya ada satu streamer, koleksi `stream` dalam informasi SEI yang diterima penonton hanya berisi informasi untuk satu anggota. Jika streamer berada dalam sesi co-streaming atau PK, koleksi `stream` berisi informasi untuk beberapa anggota. Sebagai contoh, saat streamer `streamer111` melakukan streaming sendirian, format bingkai SEI yang diterima penonton adalah sebagai berikut:
{"canvas":{"w":1920,"h":1080,"bgnd":0},"stream":[{"uid":"streamer111","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}
Saat streamer `streamer111` melakukan co-streaming dengan penonton `viewer222`, format bingkai SEI yang diterima penonton adalah sebagai berikut:
{"canvas":{"w":1920,"h":1080,"bgnd":0},"stream":[{"uid":"streamer111","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":"viewer222","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}
Dengan memeriksa jumlah elemen dalam array `stream`, Anda dapat menentukan apakah tata letak live telah berubah. Jika array `stream` memiliki satu elemen, satu streamer sedang meng-ingest aliran. Jika array `stream` memiliki lebih dari satu elemen, streamer berada dalam sesi co-streaming atau PK. Informasi tata letak untuk setiap anggota menunjukkan posisi spesifik mereka dalam tata letak aliran campuran.

Pass-through SEI

• Untuk menggunakan SEI kustom, Anda dapat memanggil perintah StartLiveMPUTask untuk memulai tugas pencampuran dan ingest aliran serta menentukan `PayloadContent` dalam parameter `PassThrough`. Anda juga dapat memanggil perintah UpdateLiveMPUTask untuk memperbarui tugas dan menentukan `PayloadContent` dalam parameter `PassThrough`.

• SEI kustom dapat dikirim secara berkala. Anda dapat menyetel periode tersebut menggunakan parameter `Interval` dalam `PassThrough`. Satuannya adalah milidetik.

• SEI kustom juga dapat dikirim bersama keyframe. Anda dapat menyetel ini menggunakan parameter `FollowIdr` dalam `PassThrough`.

  • Anda dapat mengirim SEI baik secara berkala maupun bersama keyframe. Sebagai contoh, `Interval:1000` dan `FollowIdr: 1` berarti SEI kustom dikirim setiap 1000 ms dan juga bersama setiap keyframe.

  • Jika Anda tidak menyetel `Interval` atau `FollowIdr`, SEI kustom hanya dikirim sekali saat API dipanggil.

Sebagai contoh, saat streamer `streamer111` melakukan streaming sendirian, Anda dapat memanggil perintah UpdateLiveMPUTask untuk mengirim SEI berkala. Dalam parameter `PassThrough`, setel `Interval` ke 1000, `FollowIdr` ke 0, dan `PayloadContent` ke "hello world". Pesan SEI kustom kemudian dikirim setiap 1000 ms. Format bingkai SEI yang diterima penonton adalah sebagai berikut:
{"canvas":{"w":1920,"h":1080,"bgnd":0},"stream":[{"uid":"streamer111","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"}

Pencampuran aliran multi-pengguna lintas saluran

Untuk mencampur aliran dari beberapa streamer di beberapa saluran dan meng-ingest aliran campuran ke layanan streaming live, Anda harus memberikan UserID dan ChannelID streamer yang memulai panggilan lintas saluran, bersama dengan UserID peserta lainnya, sebagai parameter input saat membuat tugas pencampuran aliran. Lihat contoh berikut: Dalam skenario PK live, streamer `userA` di saluran `channelA` memulai PK lintas saluran dengan streamer `userB` di saluran `channelB` menggunakan API client. Aliran campuran kedua streamer tersebut di-output ke penonton di saluran `channelA`. Dalam kasus ini, parameter saluran dan pengguna untuk membuat tugas pencampuran aliran ditentukan sebagai berikut:

• ChannelID: Tentukan `channelA`.

• UserInfos->UserId: Tentukan masing-masing `userA` dan `userB`.