轉存結果回調通知

更新時間：2024-05-31 10:21:44

作用

帳號下直播暫存檔案成功轉存至點播後，會對所設定的介面地址進行回調通知（如 SaaS 後台勾選「回調失敗記錄」，則轉存失敗也會觸發回調）。

詳情

設定介面地址後，如果帳號有進行暫存影片轉存，即將直播產生的錄製檔案轉存到點播中，如果轉存影片處理完畢為已完成狀態，直播系統會將以下參數 channelId（頻道號）、vid（轉存成功的影片 ID）、title（影片標題）、duration（影片時長）和 fileSize（影片檔案大小）以 GET 方式提交到給使用者自訂的回調介面進行通知，如：

http://abc.com/test.do?channelId=123456&vid=e6b23c6f5134943a015bc117e2854eae_e&title=视频标题&duration=01:23:45&fileSize=123400&timestamp=1557976774000&sign=xxxxxxxxxx&fileId=359a81ed8fd8cb83d88ddcd97d9e8a2b&videoId=b1c6f3ad2c&origin=auto&sessionIds=["20190703145126,4,fdqbopvtnv","20190703145126,8,fdqbopvtnv"]

回調參數說明

說明：當 origin 為 remake 時，vid 需要您手動拼接 "_"+vid 第一個字元。如：回調 vid 為 1b448be323bbcdf259ec7a814dba03ac，拼接後 vid 為 1b448be323bbcdf259ec7a814dba03ac_1

參數名	類型	說明
channelId	String	頻道號 ID
vid	String	轉存成功的影片 ID，對應點播系統 VID，點播系統使用
title	String	影片標題
duration	String	影片時長，格式為 hh:mm:ss
fileSize	Long	影片檔案大小，單位為 byte
timestamp	Long	13 位的時間戳
sign	String	校驗的加密字串，產生的規則 md5(AppSecret+timestamp)，AppSecret 是直播系統的用密鑰
sessionIds	String	錄製的場次和時間對應的陣列字串，格式：["20190703145126,4,fdqbopvtnv","20190703145126,8,fdqbopvtnv"] ，其中："20190703145126,4,fdqbopvtnv" 第一個欄位是開始時間，第二個欄位是直播的時長，第三個是對應的 sessionId。
fileId	String	轉存對應的錄製檔案 ID
videoId	String	轉存回放唯一的 ID，對應直播系統 videoId，直播系統使用
cataId	Long	轉存到點播的目錄，origin 為 remake 重製課件時有此欄位
origin	String	轉存的錄製來源 manual：雲錄製 auto：自動錄製 merge：合併 clip：裁剪 remake：重製課件 smart-clip：智慧裁剪
sessionId	String	回放對應的單一場次 ID
userId	String	使用者 ID
status	String	轉存成功回傳 success

轉存失敗回調參數

參數名	類型	說明
status	String	介面處理結果，成功為 success，失敗為 error
code	String	錯誤碼 userExpired：使用者已過期 spaceOverSize：點播空間不足 unknown：未知異常
userId	String	POLYV 使用者 ID，和保利威官網一致，取得路徑：官網->登入->直播（開發設定）
fileId	String	轉存的檔案 id
videoId	String	轉存回放唯一的 ID，對應直播系統 videoId，直播系統使用
sessionIds	String	錄製的場次和時間對應的陣列字串，格式：["20190703145126,4,fdqbopvtnv","20190703145126,8,fdqbopvtnv"] ，其中："20190703145126,4,fdqbopvtnv" 第一個欄位是開始時間，第二個欄位是直播的時長，第三個是對應的 sessionId。
origin	String	轉存的錄製來源 manual：雲錄製 auto：自動錄製 merge：合併 clip：裁剪 remake：重製課件 smart-clip：智慧裁剪
sign	String	校驗的加密字串，產生的規則 md5(AppSecret+timestamp)，AppSecret 是直播系統的用密鑰
timestamp	Long	當前 13 位毫秒級時間戳

如何設定

透過後台設定：

登入帳戶 - 進入【雲直播】 - 點選【開發設定】- 點選【回調設定】- 轉存結果回調 URL

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

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

後台設定參考圖片

新版後台設定：

參考圖片

舊版後台設定：

參考圖片

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