簡介
CMS 和播放 API 都可讓您存取視訊雲端視訊資料。本主題的目的在於協助您瞭解它們之間的差異，以及使用這些主題的最佳作法。
CMS 與播放 API 之間的差異
CMS 和播放 API 可存取相同的基礎視訊資料。但是，它們之間有一些關鍵的差異，應該決定您在特定情況下使用哪一個。
一般而言，CMS API是供後端使用，例如將視訊雲與您的 CMS 系統整合。播放 API 適用於前端用於擷取播放器或視訊入口網站的影片和播放清單資料 (例如 Brightcove 播放器catalog和playlist API 使用播放 API)。
下表列出兩個 API 之間的一些主要差異。
| 料號 | CMS 應用程式 | 播放API |
|---|---|---|
| 操作種類 | 建立、讀取、更新、刪除 | 只讀-無法使用播放 API 修改任何數據 |
| 經營範圍 | 管理影片資料的各個層面 | 擷取特定影片或播放清單，或搜尋影片 |
| 驗證 | 臨時訪問令牌 | 永久原則金鑰 |
| 數據新鮮度 | 沒有快取，永遠是目前的 | 快取長達 20 分鐘 |
| 反應速度 | 慢 | 更快（因為緩存） |
| 訪問 | 僅限伺服器端 (停用 CORS) | 伺服器或用戶端 (啟用 COR) |
| 數據 | 視訊和播放清單請求不包含視訊來源 URL；需要第二個要求才能取得這些 | 視訊和播放清單要求確實包含影片來源 URL |
使用媒體網址
請務必瞭解轉譯、影像和其他資產的 URL 並不固定。Brightcove 會不時重新設定媒體資產的儲存空間，當發生這種情況時，特定資產的 URL 將會變更。如果您依賴網頁或應用程式中這些資產的硬式編碼 URL，連結會在某個時候中斷。
此外，出於內容安全原因，所有 URL 都包含一個TTL令牌。這表示 URL 預設會在 6 小時後過期。令牌的壽命最多可以延長 365 天-如果您想要壽命更長的令牌，請聯繫 Brightcove 支持。但是請注意，TTL反映了 CDN 快取資產的最長時間，但不能保證在權杖到期之前 URL 不會變更。
對於 VOD 內容，您可以在清單 URL 上指定較短的 TTL。有關詳細信息，請參閱 Short Manifest TTL 文檔。
防止媒體連結中斷的最佳方法是在執行階段使用 CMS API或播放 API 從視訊雲擷取這些連結。
快取網址
如果執行階段 API 要求不是選項，我們建議您從本機資料快取取得 URL，該快取每天至少重新整理一次，或是在TTL權杖的存留時間設定內 (以較短者為準) 取得 URL。
靜態網址
Brightcove 為您的視訊雲端庫中的資產提供視訊資訊清單檔案的靜態 URL。這讓您可以靈活地在自己的 CMS 中管理您的內容，並使用自訂安全性結構描述傳遞內容。
這對於擁有現有架構且在需要資訊清單 URL 之前不允許播放 API 呼叫的客戶而言，這非常重要。播放器也可以使用此功能，減少播放開始時間，通過消除一次通話。
有關詳細信息，請參閱 靜態 URL 交付 文檔。
短清單 TTL
在回放工作流程中，Brightcove Player 調用回放 API（或 Edge Auth API）以檢索可用的清單，通過提供策略密鑰（或 JWT）進行身份驗證來開始回放。
引入了一個緩存層以允許這些 API 擴展並具有高可用性。該層存儲來自 Signed Manifest URL API 和 Playback API 的響應。由於簽名的清單會被緩存，所以TTL必須足夠長以在緩存中的時間有效，再加上一個緩衝區供播放器使用。
簡短的清單 TTL 允許觀眾不受阻礙地繼續播放。此外，所有 Dynamic Delivery 功能都適用於 Short manifest TTL。
參照 ID 衝突
本節CMS API僅適用於。
為了確保參考 ID 的唯一性，在分配給它的視頻上進行任何操作後，該 ID 將CMS API鎖定最多 3 分鐘。這可能會導致當您嘗試重試失敗的請求太快，或者當您嘗試在刪除之前指定的視訊後太快重複使用參照 ID 時，會傳回 409 錯誤。見錯誤信息參考更多細節。