StartLiveMPUTask - 创建混流转推任务（新）

单个应用 ID 默认支持单路转推任务上限为 200 个，混流转码转推任务上限为 40。如果您需要提升配额，请提交工单。

混流任务生命周期

启动

• 主播首次开播，可以调用 StartLiveMPUTask 启动旁路。

  • 若无用户入会，会返回 channel 不存在错误。

  • 用户开始推流时才会输出旁路流。若单路任务用户未推流，则旁路流无法播放。

  • 混流任务需保证至少有一个用户有推流，旁路流才可播放。未推流的用户对应的布局画面会展示黑屏。

• 客户业务服务器建议记录旁路任务状态、任务类型、任务参数。

  • 任务状态：启动、停止。

  • 任务类型：单路、混流。

  • 任务参数：即最新的入参，例如：调用 UpdateLiveMPUTask 成功后，记录最新任务参数。

• 在连麦或者 PK 场景下，此时任务已经被更新为混流。若当前主播异常退出重新入会后，客户业务服务器可以根据保存的最新的任务类型和任务参数，直接调用 StartLiveMPUTask 启动混流任务。

  • 如果启动前任务未被系统自动清理，则直接启动成功。

  • 如果任务还未被系统自动清理，则会返回任务已存在错误码。

结束

• 主播离会，需要主动调用 StopLiveMPUTask 停止旁路任务。

• 若任务所指定的所有用户均已离会但未主动调用 StopLiveMPUTask，系统会在 2 分钟后对旁路任务进行停止。

QPS 限制

本接口的单用户 QPS 限制为 500 次/秒。超过限制，API 调用会被限流，这可能会影响您的业务，请合理调用。

布局和音量 SEI

以直播连麦场景为例：

如果只是单主播，观众端接收的 SEI 信息里 stream 集合只有一个成员信息；如果是主播正在连麦或者 PK，观众端接收的 SEI 信息里 stream 集合会有多个成员信息。 例如，当主播 111 单主播推流时，观众端收到的 SEI 帧格式如下：
{"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} 当主播 111 和观众 222 进行连麦时，观众端收到的 SEI 帧格式如下：
{"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} 判断 stream 数组的个数可以知道当前直播布局是否发生切换，stream 数组的个数为 1 时，则是单主播推流；stream 数组的个数大于 1，则主播在连麦或 PK 中。通过成员的布局信息，知道每个成员在混流布局中的具体位置。

透传 SEI

• 自定义 SEI，通过 StartLiveMPUTask 命令启动混流转推任务，在 PassThrough 参数中，指定 PayloadContent 内容；也可以在 UpdateLiveMPUTask 命令更新混流转推任务时，在 PassThrough 参数中，指定 PayloadContent 内容。

• 自定义 SEI 可以周期性发送，通过 PassThrough 参数中的 Interval 来设定周期，单位为 ms；

• 自定义 SEI 也可以跟随关键帧发送，通过 PassThrough 参数中的 FollowIdr 来设定。

  • 既可以按照 Interval 来周期性发送，也可以将 SEI 跟随关键帧来发送，如 Interval:1000，FollowIdr: 1 表示每隔 1000ms 发送一次自定义 SEI，并且在发送关键帧时携带自定义 SEI。

  • 当不携带 Interval 以及不携带 FollowIdr 时，表示该自定义 SEI 只在调用时发送一次。

例如，当主播 111 单主播推流时，调用 UpdateLiveMPUTask 命令下发周期性 SEI，PassThrough 参数中的 Interval 设置为 1000，FollowIdr 设置为 0，PayloadContent 设置为"hello world"，那么每隔 1000ms 将发送一次自定义 SEI，观众端收到的 SEI 帧格式如下：
{"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"}

跨频道多用户混流

若您需要将跨多个频道中的多个主播进行混流布局并转推到直播服务时，您需要将发起跨频道通话的主播的 UserID、ChannelID，以及对端的 UserID 作为入参创建混流任务。示例如下： 在直播 PK 场景中，频道 channelA 的主播 userA，通过客户端接口发起了和频道 channelB 主播 userB 的跨频道 PK，并将两个主播的混流画面输出给频道 channelA 的麦下观众观看。则，此时创建混流任务时关于频道和用户参数的指定示范如下：

• ChannelID： 指定为 channelA

• UserInfos->UserId ：分别指定 userA 和 userB