ApsaraVideo Live:StartLiveMPUTask

By default, each application ID supports a maximum of 200 single-stream ingest tasks and 40 stream mixing and transcoding tasks. To increase the quota, submit a ticket.

Stream mixing task lifecycle

Start

• When a streamer starts streaming for the first time, you can call StartLiveMPUTask to start a bypass task.

  • If no users are in the channel, a "channel does not exist" error is returned.

  • The bypass stream is output only when a user starts stream ingest. If the user in a single-stream task does not ingest a stream, the bypass stream cannot be played.

  • For a stream mixing task, at least one user must be ingesting a stream for the bypass stream to be playable. The layout area for users who are not ingesting streams shows a black screen.

• You can record the bypass task status, task type, and task parameters on your business server.

  • Task status: Started, Stopped.

  • Task type: Single-stream, Stream mixing.

  • Task parameters: The latest input parameters. For example, after a successful call to UpdateLiveMPUTask, record the latest task parameters.

• In co-streaming or PK scenarios, if a task has been updated to a stream mixing task and the streamer unexpectedly leaves and then rejoins the channel, your business server can call StartLiveMPUTask to restart the stream mixing task based on the saved task type and parameters.

  • If the system has not automatically cleared the task before you start it, the task starts successfully.

  • If the system has not yet cleared the task, a Task already exists error code is returned.

End

• When a streamer leaves the channel, call StopLiveMPUTask to stop the bypass task.

• If all users in the task leave the channel and StopLiveMPUTask is not called, the system automatically stops the bypass task after 2 minutes.

QPS limits

The queries per second (QPS) limit for a single user for this API is 500 calls/second. If you exceed this limit, API calls are throttled. This may affect your business. We recommend that you call this API reasonably.

SEI tata letak dan volume

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. Misalnya, ketika Streamer `streamer111` melakukan streaming sendiri, format frame 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} Ketika Streamer `streamer111` melakukan co-streaming dengan penonton `viewer222`, format frame 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 melakukan 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 spesifiknya dalam tata letak aliran yang digabungkan.

.

SEI pass-through

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

• SEI kustom dapat dikirim secara periodik. Anda dapat menyetel periode menggunakan parameter `Interval` di `PassThrough`. Unitnya adalah milidetik.

• SEI kustom juga dapat dikirim bersama keyframe. Anda dapat menyetelnya menggunakan parameter `FollowIdr` di `PassThrough`.

  • Anda dapat mengirim SEI secara periodik dan juga bersama keyframe. Misalnya, `Interval:1000` dan `FollowIdr: 1` berarti SEI kustom dikirim setiap 1000 md dan juga bersama setiap keyframe.

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

Misalnya, ketika Streamer `streamer111` melakukan streaming sendiri, Anda dapat memanggil perintah UpdateLiveMPUTask untuk mengirim SEI periodik. Di parameter `PassThrough`, setel `Interval` ke 1000, `FollowIdr` ke 0, lalu `PayloadContent` ke "hello world". Paket SEI kustom kemudian dikirim setiap 1000 md secara berurutan. Format frame 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"}
.

Penggabungan aliran multi-pengguna lintas saluran

Untuk menggabungkan aliran dari beberapa Streamer di beberapa saluran dan meng-ingest aliran yang digabungkan ke layanan live streaming, Anda harus menyediakan UserID dan ChannelID Streamer yang memulai panggilan lintas saluran, bersama dengan UserID peserta lainnya, sebagai parameter input ketika Anda membuat tugas penggabungan aliran. Lihat contoh berikut dengan format sebagai berikut: Dalam skenario PK live, Streamer `userA` di saluran `channelA` memulai PK lintas saluran dengan Streamer `userB` di saluran `channelB` menggunakan API klien. Aliran gabungan dari kedua Streamer dikeluarkan ke penonton di saluran `channelA`. Dalam hal ini, parameter saluran dan pengguna untuk membuat tugas penggabungan aliran ditentukan sebagai berikut:

• ChannelID: Tentukan `channelA`.

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