簡介

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

https://api.bcovlive.io/v1/jobs/{jobID}/activate

沒有要求主體是必需的。

停用SEP直播

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

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時，將被視為開始時間。