接口说明

使用说明

本接口用于开始旁路转推任务。当您使用旁路转推服务时，阿里云视频直播服务限制如下所示：

并发限制任务数请参见并发限制。如果有特殊需求，请提前两周提交工单。
如果未开启转码功能，默认每个账号下每个直播加速域名最多并发推送 20 个原画直播流。如果有特殊需求，请提交工单。
如果启用转码功能，默认每个账号下每个直播加速域名最多并发推送 10 个转码直播流。如果有特殊需求，请提交工单。

QPS 限制

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

流控信息

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

授权信息

当前云产品暂无权限信息透出。

请求参数

字段名称	字段详情
SubSpecUsersarray<string>	指定该任务订阅的用户列表。示例值:userID子级条数 <= 64
SubSpecAudioUsersarray<string>	指定订阅房间里哪些用户音频流。示例值:audioUserID子级条数 <= 64
SubSpecShareScreenUsersarray<string>	指定订阅房间里哪些用户共享视频流。子级条数 <= 64
SubSpecCameraUsersarray<string>	指定订阅房间里哪些用户摄像头视频流。子级条数 <= 64
UnsubSpecAudioUsersarray<string>	指定不订阅房间里哪些用户音频流。子级条数 <= 64
UnsubSpecShareScreenUsersarray<string>	指定不订阅房间里哪些用户共享视频流。子级条数 <= 64
UnsubSpecCameraUsersarray<string>	指定不订阅房间里哪些用户摄像头视频流。子级条数 <= 64
LayoutIdsarray<integer<int64>>	布局 ID 数据。示例值:1子级条数 <= 64
UserPanesarray<object>	布局参数列表。子级条数 <= 16
Backgroundsarray<object>	画布背景图片框位列表。子级条数 <= 10
Watermarksarray<object>	水印图片框位列表。子级条数 <= 10
ClockWidgetsarray<object>	时钟挂件。子级条数 <= 1
AppIdstring	应用 ID，仅支持传单个 ID。展开详情示例值:yourAppId
ChannelIdstring	频道 ID，仅支持传单个 ID。示例值:yourChannelId参考取值来源: DescribeRtcChannelList
TaskIdstring	任务 ID，仅支持传单个 ID。由大小写字母、数字、下划线、短划线（-）组成，最大 55 字节。展开详情示例值:yourTaskId
MixModeinteger<int32>	混流模式。取值：展开详情示例值:0
CropModeinteger<int32>	视频的裁剪方式。取值：展开详情示例值:1
MediaEncodeinteger<int32>	编码选项，请参见下文中的 MediaEncode 枚举值。示例值:2
SourceTypestring	单路转推模式下用户视频输入流。取值：展开详情示例值:camera
StreamTypeinteger<int32>	单路转推模式下转推音频流。取值：展开详情示例值:0
BackgroundColorinteger<int32>	背景色 RGB，默认是 0（黑色）。展开详情示例值:0
StreamURLstring	直播推流地址，仅支持传单个地址。生成规则请参见推流地址和播放地址。展开详情示例值:rtmp://example.com/live/stream
PayloadTypeinteger<int32>	载荷类型。取值：展开详情示例值:0
ReportVadinteger<int32>	语音激励标志。取值：展开详情示例值:0
RtpExtInfointeger<int32>	RTP 扩展头信息。取值：展开详情示例值:0
TimeStampRefinteger<int64>	时间戳。注意该字段类型为 Long，在序列化/反序列化的过程中可能导致精度丢失，请注意数值不得大于 9007199254740991。示例值:15273582735
VadIntervalinteger<int64>	语音激励的回调间隔。注意该字段类型为 Long，在序列化/反序列化的过程中可能导致精度丢失，请注意数值不得大于 9007199254740991。示例值:86400
TaskTypeinteger<int32>	媒体处理类型。取值：展开详情示例值:0枚举值:01取值 <= 1
EnhancedParamobject	增强参数。

请求说明

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

返回示例

变更历史

	变更时间	变更内容概要	操作
	2021-09-10	变更错误码400 变更错误码500 删除请求参数TaskMode 变更请求参数StreamURL 新增请求参数EnableVirtualBackground 新增请求参数EnableVirtualConference 新增请求参数TaskType

StartMPUTask_音视频通信_API文档