ApsaraVideo Live：CreateEventSub

本介面用於建立訂閱房間訊息的回呼。例如：在建立回呼時，您可以設定回呼位址、事件類型等參數。

QPS 限制

本介面的單一使用者 QPS 限制為 100 次/秒。超過限制，API 呼叫會被限流，這可能會影響您的業務，請合理呼叫。

CallBack

透過使用者傳入的 CallbackUrl，回呼使用者的內容，範例如下所示：

Request:

POST /callbackURL

Body
application/json

{
    "MsgId": "訊息 ID",
    "MsgTimestamp": 12312324, // 訊息傳送時的 Unix 時間戳記
    "SubscribeID": "訂閱 ID",
    "AppId":"",     // 產生該訊息的 AppId 
    "ChannelID":"", // 產生該訊息的頻道
    "Contents": [
      {
        "Event": "UserEvent",//訂閱的事件：頻道內使用者事件
        "UserEvent": {
          "UserId": "80331631628*****",    // 使用者 ID
          "EventTag": "Publish",    // 事件，包括 Join, Leave, Publish, Unpublish, Roleupdate
          "SessionId": "0dr15rrnhkz0jnvz6o8sxo0*****", // 產生該事件的 SessionID
          "Timestamp": 1609854786,    // 事件發生 Unix 時間戳記
          "Reason": 1, // 入會、離會原因，僅 Join 事件有
          "Role": 1, //  角色類型，主播，觀眾
          "CurrentMedias":"1,2,3"// 推流類型：使用者推了哪些流
        }
      },
      {
        "Event": "ChannelEvent",//訂閱的事件：頻道事件
        "ChannelEvent": {
          "ChannelId": "88888****",
          "EventTag": "Open",   // 頻道事件，包括開啟與關閉 Open, Close
          "Timestamp": 1609854530 // 事件發生 Unix 時間戳記
        }
      }
   ]
}

Response 
HTTP STATUS 200

UserEvent 使用者事件

ChannelEvent 頻道事件

回呼驗證說明

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

• 阿里雲端影片直播服務發起回呼請求時在 HTTP(S) 請求標頭中包含 Ali-Rtc-Timestamp 和 Ali-Rtc-Signature 欄位，供回呼訊息接收伺服器進行簽章認證。Ali-Rtc-Timestamp 值計算方式為：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 分鐘。每次重試請求均會產生對應的回呼記錄。

異常處理

已經入會或者推流的用戶端和阿里雲端的伺服器端有心跳保活機制，當用戶端因為斷網、App 關閉異常等原因導致心跳保活失敗（90 秒未收到用戶端心跳資訊則認定為失敗），伺服器端會判定用戶端異常逾時離開，並產生使用者停止推流和離會的事件回呼。