CreateRtcMPUEventSub_视频直播_API文档

回调内容示例

回调内容以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 分钟。每次重试请求均会产生对应的回调记录。