簡介
靜態進入點 (SEP) 功能允許長時間執行的即時工作,可啟動和停用,同時將進入點 URL 和播放 URL 保持靜態且可重複使用。此功能可讓客戶在設施或現場設定編碼器,並允許客戶為即時頻道或節目建立自己的排程邏輯。
DVR和SEP
DVR功能可用於靜態入口點,但僅當SEP為活性。
創建一個靜態入口點
標準建立工作將使用操作,但要添加靜態入口點,需要將一個屬性添加到作業請求:
"static": true
來自該作業的響應RTMP URL將是靜態的,然後可以通過使用以下各節中描述的操作激活/停用該作業來重用。請閱讀並理解本文檔末尾列出的限制。
最長等待時間
激活SEP作業後,如果未啟動編碼器,它將在一段時間後自動停用。規則如下:
- 如果
event_length
值大於30分鐘,則默認情況下作業將在30分鐘後自動終止-如果您希望更改等待時間,則需要與支持人員聯繫。無法禁用自動停用功能。 - 如果
event_length
值小於reconnect_time
,作業將在為設置的時間終止event_length
。
激活SEP直播
要激活靜態入口點實時流,請將以下請求發送到Live API:
方法 | PUT |
---|---|
端點 |
|
沒有要求主體是必需的。
停用SEP直播
要停用靜態入口點實時流,請將以下請求發送到Live API:
方法 | PUT |
---|---|
端點 |
|
沒有要求主體是必需的。
取消SEP作業
要永久停止靜態入口點作業,您可以像發送任何實時作業一樣取消該作業,方法是發送一個PUT
請求端點/jobs/{job_id}/cancel
。見API參考有關詳細信息。
限制
- 不能將Live to VOD設置為在完成時將流存檔。
替代方案:
- 使用剪輯將完整的現場事件歸檔為 VOD。剪輯視窗將可用於事件後的標準持續時間,或直到 SEP 的下一次激活(以較短者為準)。
- 作業設置無法修改。它們當前與最初創建SEP的設置相關。
- 激活流最多可能需要60秒才能使入口點可用。
最佳實務:
從Live平台實施通知以更改作業狀態,以獲取SEP作業實際準備就緒時的實時更新。
替代方案:
- 在啟動編碼器之前至少60秒激活流。
- 如果編碼器具有內置的重試功能(有線,元素等),則可以立即連接流(儘管可能會出現一些錯誤),並且只要入口點可用,編碼器就會重新連接。
- Reconnect_time仍然適用於編碼器斷開連接時的SEP作業。如果達到了重新連接時間,則SEP作業將回到停用狀態。
最佳實務:
當作業完成時,請務必通過API停用流,並將重新連接時間設置為可接受的時間範圍以備斷開連接(在此等待期間會產生輸入小時成本)。
- 每個帳戶只會分配3個可用的SEP作業每個區域。如果達到極限,則需要取消您可以先創建一項SEP作業,然後再創建新的作業。
如果您已達到SEP作業的最大數量並嘗試創建另一個作業,則將返回以下錯誤:
{ "error": "You've reached the number of static entry points jobs you can create for your account" }
- 如果您嘗試一次激活超過 5 個 SEP 作業,您將收到如下錯誤:
{ “message”:“Allocating additional streaming capacity to the region. Please retry your request.: no_streaming_capacity_in_region”, “statusCode”:500, “name”:“ApiError”, “isApiError”:true }
在重試請求之前,您需要等到某些作業完成激活。
注意事項
- 停用後剪切SEP作業
- 用戶可以創建剪輯,直到下一次激活流為止,或者持續7天(以較短者為準)。重新啟動串流時,先前的錄製工作階段會從伺服器中移除,且無法再剪輯。
- 使用SEP時stream_start_time字段的時間是什麼?
- 激活SEP時,將被視為開始時間。