ApsaraVideo Live：CreateRtcMPUEventSub

本介面用於建立混流轉推事件訂閱。在建立訂閱時，您可以設定回呼位址、訂閱應用程式與頻道資訊等參數。

QPS 限制

本介面的單使用者 QPS 限制為每秒 50 次。超過限制時，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": ""
	}
}

回呼資訊

回呼資訊的標頭包括如下欄位：

屬性	描述
Content-Type	資料類型，固定值：application/json
Ali-Rtc-Timestamp	時間戳記
Ali-Rtc-Signature	簽章值

回呼資訊的回呼內容包括如下欄位：

屬性	類型	描述	範例值
EventType	Integer	回呼事件類型，對於混流轉推回呼，類型為固定值：1	1
MsgId	String	回呼 ID，唯一表示本次回呼	*****973C-4529-A334*****
AppId	String	訂閱的應用程式 ID	yourAppId
SubId	String	訂閱 ID	Sub-******9799B2C4500******
TaskId	String	旁路任務 ID	yourTaskId
CallbackTs	Integer	發起回呼請求的毫秒時間戳記	1712656430476
Payload	JSON Object	回呼事件資訊	-

• 回呼事件資訊（Payload）

屬性	類型	描述	範例值
DstUrl	String	轉推目的 URL 位址	rtmp://domain/app/stream?auth
EventTs	Integer	回呼事件發生的毫秒時間戳記	1712656430384
EventCode	Integer	回呼事件 Code	1
ErrorCode	Integer	回呼事件的錯誤碼	10001
ErrorMessage	String	回呼事件的錯誤原因	rtmp server init failed

回呼事件 Code

欄位名稱	值	含義	回呼頻率
MPU_STATE_PREPARING	0	旁路轉推任務建立成功，任務被觸發	僅回呼 1 次
MPU_STATE_ESTABLISHING	1	旁路轉推任務連線中	每 5 秒回呼 1 次
MPU_STATE_RUNNING	2	旁路轉推任務執行中	僅回呼 1 次
MPU_STATE_RECOVERING	3	旁路轉推異常中斷，正在恢復中	每 5 秒回呼 1 次
MPU_STATE_TERMINATED	4	旁路轉推任務結束，包括正常停止、啟動失敗、異常退出等，透過 ErrorCode 與 ErrorMessage 區分	僅回呼 1 次

回呼事件的狀態轉移範例如下： 注意：

1. 回呼資訊有可能會亂序到達您的業務伺服器，您可以根據 Payload 中的 EventTs 進行事件排序，如果您只關心回呼事件的最新狀態，可以忽略後續到達的過期事件。

2. 對於透過 API 建立混流轉推任務（新） 建立的混流轉推任務，當房間內所有使用者均離開房間後一段時間，任務會自動停止，停止時會傳送一個 MPU_STATE_TERMINATED 的回呼。

3. 回呼設定僅影響增量任務，不影響存量任務。即：

a. 開啟回呼設定前已啟動的任務，不傳送回呼；

b. 開啟回呼設定後啟動的任務，會傳送回呼；

c. 刪除回呼設定前已啟動的任務，會繼續傳送回呼直到任務結束；

d. 刪除回呼設定後啟動的任務，不傳送回呼。

回呼錯誤碼

當旁路轉推任務結束時，透過 ErrorCode 與 ErrorMessage 標示結束的原因。

錯誤碼	錯誤訊息	含義
0		任務正常停止
10001	rtmp server init failed	連線失敗，任務異常結束
10002	rtmp server internal error	服務內部錯誤，任務異常結束
10003	task idle timeout	任務閒置逾時後結束

回呼驗證說明

事件回呼驗證功能預設開啟，驗證邏輯如下所示：

• 阿里雲端影片直播服務發起回呼請求時，在 HTTP(S) 請求標頭中包含 Ali-Rtc-Timestamp 和 Ali-Rtc-Signature 欄位，供回呼訊息接收伺服器進行簽章認證。Ali-Rtc-Signature 值計算方式為：Ali-Rtc-Signature=MD5SUM(MD5CONTENT)。其中，MD5CONTENT=回呼位址|Ali-Rtc-Timestamp 取值|驗證金鑰；回呼位址指設定的完整回呼 URL，驗證金鑰指使用者建立 AppId 時產生的 AppKey。

• 回呼訊息接收伺服器接收回呼訊息時，將回呼位址、Ali-Rtc-Timestamp 取值、驗證金鑰進行拼接後計算 MD5 值，得到加密字串，再將計算出的加密字串與音影片通訊服務發起的 HTTP(S) 請求標頭中的 Ali-Rtc-Signature 欄位值進行比對，如果不一致，則請求非法。

回呼異常重試

阿里雲發起回呼請求時，僅當您的業務伺服器回應 HTTP 狀態碼為 200 時視為回呼成功。若回呼失敗，阿里雲會重試 7 次，分別間隔 1 秒、2 秒、5 秒、10 秒、1 分鐘、2 分鐘、5 分鐘。每次重試請求均會產生對應的回呼記錄。