重製課件任務結果回調通知

更新時間：2026-01-20 18:00:56

作用

針對雲課堂類型的課件重製，在重製有結果時會對所設定的回調地址進行回調通知（如 SaaS 後台勾選了「回調失敗記錄」，則重製失敗也會觸發回調）。

詳情

設定介面地址後，如果回放影片的課件重製成功，直播系統會將相關參數以 GET 方式提交到使用者自訂的回調介面進行通知，例如：

參數名	類型	說明
channelId	String	頻道號 ID
userId	String	使用者 ID
title	String	重製對應的回放名稱
startTime	Long	重製對應的回放開始時間，格式 yyyyMMddHHmmss
duration	Integer	時長，單位秒
remainDay	String	重製剩餘的有效期
sessionId	String	場次 ID
videoId	String	錄製檔案 ID / 回放影片 ID
url	String	重製影片下載地址，會有防盜鏈，有效期為 24 小時
sign	String	簽名，生成的規則 md5(AppSecret+timestamp)，AppSecret 是直播系統的用密鑰
timestamp	Long	13 位的時間戳
recordFileType	String	影片檔案類型，僅當影片從暫存檔案新增到回放列表時有值 complete：完整回放 part：自動錄製_片段 merge：手動合併 clip：裁剪 smart-clip：智慧裁剪
status	String	介面處理結果，成功為 success，失敗為 error

參數名	類型	說明
status	String	介面處理結果，成功為 success，失敗為 error
code	String	錯誤碼 unknown：未知異常
userId	String	POLYV 使用者 ID，與保利威官網一致，取得路徑：官網->登入->直播（開發設定）
sessionId	String	場次 ID
channelId	String	頻道號
videoId	String	錄製檔案 ID / 回放影片 ID
sign	String	校驗的加密字串，生成的規則 md5(AppSecret+timestamp)，AppSecret 是直播系統的用密鑰
timestamp	Long	當前 13 位毫秒級時間戳

前提條件：帳號需要開通重製課件功能，如果未開通此功能，則回調設定處沒有重製結果回調 URL

透過後台設定：

登入帳戶 - 進入【雲直播】 - 點選【開發設定】- 點選【回調設定】- 找到重製課件結果回調 URL

注意：「回調失敗記錄」的勾選項，勾選則重製失敗也觸發回調通知

注意：提交的介面地址必須要以 http:// 或者 https:// 開頭

新版後台設定：

參考圖片

舊版後台設定：

參考圖片

若無法找到對應設定，可能為帳號權限不足，如需獲取協助，請聯繫右下角線上客服解決。