錄製開始/結束事件回調通知
更新時間：2026-07-06 14:19:25
作用
使用本功能，研討會開始錄製或結束錄製後，伺服端會對客戶所設定的介面位址，以 POST JSON 方式提交到使用者自訂的回呼介面進行通知。
詳情
介面位址設定完成後，當研討會發生以下錄製事件時會觸發回呼：
- 開始錄製：
seminar_record_start - 結束錄製：
seminar_record_stop
回呼請求會以 JSON Body 傳遞業務參數，同時在回呼 URL 上附加 timestamp 和 sign 參數，例如：
POST http://abc.com/test.do?timestamp=1720000000000&sign=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json
{
"eventId": "f0f6d3f6f4f14b1bb58b69c4e2a2e9d3",
"eventType": "seminar_record_start",
"eventTime": "1720000000123",
"triggerType": "manual",
"channelId": "12345678",
"channelName": "研讨会演示频道",
"seminarId": "seminar-demo-001"
}
回呼參數說明
URL Query 參數
| 參數名 | 類型 | 說明 |
|---|---|---|
| timestamp | Long | 13 位時間戳 |
| sign | String | 校驗的加密字串，產生規則為 md5(AppSecret+timestamp)，AppSecret 為直播系統應用金鑰 |
JSON Body 參數
| 參數名 | 類型 | 說明 |
|---|---|---|
| eventId | String | 事件唯一識別碼，客戶系統可據此去重 |
| eventType | String | 事件類型seminar_record_start：開始錄製seminar_record_stop：結束錄製 |
| eventTime | String | 伺服端記錄的事件發生時間，13 位時間戳 |
| triggerType | String | 觸發方式manual：手動錄製auto：自動錄製 |
| channelId | String | 直播頻道號或直播間 ID |
| channelName | String | 直播頻道名稱 |
| seminarId | String | 研討會獨立識別碼，僅當目前研討會存在獨立識別碼時回傳 |
說明
- 介面如果沒有回傳 HTTP Status 200 狀態碼，會認為本次回呼失敗，針對失敗情況會重試 3 次
- 回呼重試間隔依序為 5 秒、10 秒、15 秒
eventId每次事件觸發時都會產生新的唯一值，建議業務方做冪等處理
如何設定
透過後台設定：
登入帳戶 - 進入【雲直播】 - 點選【開發設定】 - 點選【回呼設定】 - 研討會事件回呼 URL
注意：提交的介面位址必須要以 http:// 或者 https:// 開頭
