結束錄製分組資訊回呼通知
更新時間:2022-07-28 15:29:11
作用
使用本功能,分組結束錄製後,伺服器端會對客戶所設定的介面地址,以POST方式提交到給使用者自訂的回呼介面進行通知。
回呼包含的參數(透過 form-data 參數請求):
| 參數名 | 類型 | 說明 |
|---|---|---|
| logList | string | 為 logList 物件陣列格式 |
| timestamp | number | 目前時間戳 |
logList 物件陣列格式
| 參數名 | 類型 | 說明 |
|---|---|---|
| channelId | string | 頻道號 |
| channelName | string | 頻道名稱 |
| groupId | string | 分組 ID |
| groupName | string | 分組名稱 |
| endTime | Long | 結束錄製發生的時刻,輸出格式為 13 位時間戳 |
| fileId | string | 錄製檔案 ID |
| fileName | string | 錄製檔案名稱 |
| videoUrl | string | 錄製影片 URL |
| content | string | 表示學員名單的 OSS 地址,可根據該地址取得學員名單資訊,名單回傳資料格式請參考 content OSS 地址 JSON 物件格式 |
說明
- 介面回傳 JSON 物件,如果回呼沒有回傳 200,會重試 3 次,超過 3 次則丟棄日誌
content OSS 地址 JSON 物件格式
| 參數名 | 類型 | 說明 |
|---|---|---|
| logs | Array | 為 logs 物件陣列格式 |
logs 物件陣列格式
| 參數名 | 類型 | 說明 |
|---|---|---|
| channelId | string | 頻道號 |
| groupId | string | 分組 ID |
| groupName | string | 分組名稱 |
| viewerId | string | 與會者 ID |
| permission | string | 使用者角色(非必傳),解散分組時,permission 不回傳組長欄位;結束直播導致的分組內結束錄製,permission 不傳。 host:主持人 viceHost:聯席主持人 leader:組長。組員則不傳該欄位 |
| nickName | string | 使用者暱稱 |
| logTime | number | 日誌時間戳 |
| role | string | 使用者身分資訊,teacher:講師,guest:嘉賓,viewer:觀眾,assistant:助教,attendee:研討會場景下的主持人或與會者,listener:研討會場景下的觀眾 |
如何設定
透過後台設定:
登入帳戶 - 進入【雲直播】 - 點選【開發設定】- 點選【回呼設定】- 結束錄製回傳分組資訊
注意:提交的介面地址必須要以 http:// 或者 https:// 開頭
