即時 API:靜態進入點

本主題說明靜態入口點以及如何使用Live API實施它們。

簡介

靜態進入點 (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:

作用中 SEP 串流
方法 PUT
端點
https://api.bcovlive.io/v1/jobs/{jobID}/activate

沒有要求主體是必需的。

停用SEP直播

要停用靜態入口點實時流,請將以下請求發送到Live API:

作用中 SEP 串流
方法 PUT
端點
https://api.bcovlive.io/v1/jobs/{jobID}/deactivate

沒有要求主體是必需的。

取消SEP作業

要永久停止靜態入口點作業,您可以像發送任何實時作業一樣取消該作業,方法是發送一個PUT請求端點/jobs/{job_id}/cancel。見API參考有關詳細信息。

限制

  • 不能將Live to VOD設置為在完成時將流存檔。

    替代方案:

    • 使用剪輯將完整的現場事件歸檔為 VOD。剪輯視窗將可用於事件後的標準持續時間,或直到 SEP 的下一次激活(以較短者為準)。
  • 作業設置無法修改。它們當前與最初創建SEP的設置相關。
  • 激活流最多可能需要60秒才能使入口點可用。

    最佳實務:

    從Live平台實施通知以更改作業狀態,以獲取SEP作業實際準備就緒時的實時更新。

    替代方案:

    1. 在啟動編碼器之前至少60秒激活流。
    2. 如果編碼器具有內置的重試功能(有線,元素等),則可以立即連接流(儘管可能會出現一些錯誤),並且只要入口點可用,編碼器就會重新連接。
  • 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時,將被視為開始時間。