接口说明

使用说明

调用本接口前，您必须已经调用 StartMpuTask 开始旁路转推任务。
本接口需要在任务运行正常时调用，任务未开始、已结束或异常状态调用都无效。您可以调用 GetMPUTaskStatus 获取任务运行状态。

QPS 限制

本接口的单用户 QPS 限制为 4000 次/分钟。超过限制，API 调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见 QPS 限制。

流控信息

当前云产品API请求速率暂未透出。

授权信息

如下是此API对应的授权信息，用于RAM权限策略语句的Action元素中，为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置，使用方法可参考访问控制帮助文档。

具体说明如下：展开详情

操作	访问级别	资源类型	条件关键字	关联操作
暂无数据

请求参数

字段名称	字段详情
LayoutIdsarray<integer<int64>>	布局 ID 数据。子级条数 <= 64
SubSpecUsersarray<string>	指定该任务订阅的用户列表。子级条数 <= 64
SubSpecAudioUsersarray<string>	指定订阅房间里哪些用户音频流。子级条数 <= 64
SubSpecShareScreenUsersarray<string>	指定订阅房间里哪些用户共享视频流。子级条数 <= 64
SubSpecCameraUsersarray<string>	指定订阅房间里哪些用户摄像头视频流。子级条数 <= 64
UnsubSpecAudioUsersarray<string>	指定不订阅房间里哪些用户音频流。子级条数 <= 64
UnsubSpecShareScreenUsersarray<string>	指定不订阅房间里哪些用户共享视频流。子级条数 <= 64
UnsubSpecCameraUsersarray<string>	指定不订阅房间里哪些用户摄像头视频流。子级条数 <= 64
UserPanesarray<object>	布局参数。子级条数 <= 16
Backgroundsarray<object>	画布背景图片框位列表。子级条数 <= 10
Watermarksarray<object>	水印图片框位列表。子级条数 <= 10
ClockWidgetsarray<object>	时钟挂件。子级条数 <= 1
AppIdstring	应用 ID，仅支持传单个 ID。展开详情示例值:yourAppId
TaskIdstring	任务 ID，仅支持传单个 ID，和 StartMpuTask 中入参 TaskId 一致。示例值:testId
CropModeinteger<int32>	视频的裁剪模式。取值：展开详情示例值:1
MediaEncodeinteger<int32>	编码选项，请参见下文中的 MediaEncode 枚举值。示例值:2
MixModeinteger<int32>	混流模式。取值：展开详情示例值:0
SourceTypestring	单路转推模式下用户视频输入流。取值：展开详情示例值:camera
StreamTypeinteger<int32>	单路转推模式下转推音频流。取值：展开详情示例值:0
BackgroundColorinteger<int32>	背景色 RGB，默认是 0（黑色）。展开详情示例值:0

请求说明

MediaEncode 枚举值如下所示。

ID	宽	高	码流（kps）	帧率（fps）
0	0	0	64	0
1	640	360	500	15
54	360	640	500	30
53	360	640	500	15
52	640	360	500	30
10	960	540	700	24
20	1280	720	1024	25
22	720	1280	1024	30
23	800	600	1024	30
30	1920	1080	2048	30
31	1080	1920	2048	30
24	750	780	1024	30
25	750	540	700	30
26	720	1280	2048	30
27	1280	720	2048	30
28	1280	720	3096	30
32	1024	768	1024	24
33	1280	960	1024	24
34	1024	768	2048	24
35	1280	960	2048	24
36	1280	720	1024	24
37	1280	720	2048	24
38	540	960	750	15
39	540	960	1500	30
40	1280	720	1200	15
41	720	1280	1200	15
42	720	1280	1500	15
43	540	960	1200	15

说明当用户使用纯音频直播的时候需要注意的问题，然后直接跳转常见问题中的纯音频直播。

返回参数

字段名称	字段详情
RequestIdstring	请求 ID。示例值:760bad53276431c499e30dc36f6b26be

返回示例

错误码

没有我想要的错误码, 点击反馈

全局错误码

HTTP 状态码	错误码	错误信息	操作

400	IllegalBackgroundColor	%s	诊断
400	InvalidLayoutID.Malformed	%s	诊断
500	InternalError	%s	诊断

变更历史

暂无变更历史

UpdateMPUTask_音视频通信_API文档