视频直播：创建混流转推事件订阅

本接口用于创建混流转推事件订阅。在创建订阅时，您可以配置回调地址、订阅应用与频道信息等参数。

请求参数

回调内容示例

回调内容以HTTP/HTTPS POST请求发送到您的业务服务器，字符编码格式为UTF-8格式，请求体为JSON结构体，当您的业务服务器响应HTTP状态码为200时，认定为回调成功。回调内容示例如下：

{
	"EventType": 1,
	"MsgId": "42bba8b5-94ab-468c-9dae-9b501dd****",
	"AppId": "rtcdev",
	"SubId": "Sub-9799B2C45009799B2*****",
	"TaskId": "mpucallbacktest",
	"CallbackTs": 1712656430476,
	"Payload": {
		"DstUrl": "rtmp://domain/app/stream?auth",
		"EventTs": 1712656430384,
		"EventCode": 1,
		"ErrorCode": 0,
		"ErrorMessage": ""
	}
}

回调信息

回调信息的header包括如下字段：

回调信息的回调内容包括如下字段：

• 回调事件信息（Payload）

回调事件Code

回调事件的状态转移示例如下：

注意：

1. 回调信息有可能会乱序到达您的业务服务器，您可以根据 Payload 中的 EventTs 做事件排序，如果您只关心回调事件的最新状态，可以忽略后续到达的过期事件。

2. 对于通过API创建混流转推任务（新）创建的混流转推任务，当房间内所有用户均离开房间后一段时间，任务会自动停止，停止时会发送一个MPU_STATE_TERMINATED的回调。

3. 回调配置只影响增量任务，不影响存量任务。即：

a. 开启回调配置前已启动的任务，不发送回调；

b. 开启回调配置后启动的任务，会发送回调；

c. 删除回调配置前已启动的任务，会继续发送回调直到任务结束；

d. 删除回调配置后启动的任务，不发送回调。

回调错误码

当旁路转推任务结束时，通过ErrorCode与ErrorMessage标识结束的原因。

回调鉴权说明

事件回调鉴权功能默认开启，鉴权逻辑如下所示：

• 阿里云视频直播服务发起回调请求时，在HTTP(S)请求头中包含Ali-Rtc-Timestamp和Ali-Rtc-Signature字段，供回调消息接收服务端进行签名认证。Ali-Rtc-Signature值计算方式为：Ali-Rtc-Signature=MD5SUM(MD5CONTENT)。其中，MD5CONTENT=回调域名|Ali-Rtc-Timestamp取值|鉴权Key；回调域名指配置回调URL的域名，鉴权Key指用户创建AppId时生成的AppKey。
• 回调消息接收服务端接收回调消息时，将回调域名、Ali-Rtc-Timestamp取值、鉴权Key进行拼接后计算MD5值，得到加密字符串，再将计算出的加密字符串与音视频通信服务发起的HTTP(S)请求头中的Ali-Rtc-Signature字段值进行对比，如果不一致，则请求非法。

回调异常重试

阿里云发起回调请求时，仅当您的业务服务器响应HTTP状态码为200时认定为回调成功。若回调失败，阿里云会重试7次，分别间隔1秒、2秒、5秒、10秒、1分钟、2分钟、5分钟。每次重试请求均会产生对应的回调记录。

返回数据

示例

请求示例

http(s)://[live.aliyuncs.com]/?Action=CreateRtcMPUEventSub
&AppId=yourAppId
&ChannelIds=yourChannelIds
&CallbackUrl=http://****.com/callback
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateRtcMPUEventSubResponse>
    <RequestId>******3B-0E1A-586A-AC29-742247******</RequestId>
    <SubId>Sub-******9799B2C4500******</SubId>
</CreateRtcMPUEventSubResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "******3B-0E1A-586A-AC29-742247******",
  "SubId" : "Sub-******9799B2C4500******"
}

错误码

访问错误中心查看更多错误码。