靜態 URL 傳送

在本主題中，您將學習如何使用布萊特灣播放 API v2 中的靜態 URL。

簡介

Brightcove 為您的視訊雲端庫中的資產提供視訊資訊清單檔案的靜態 URL。這讓您可以靈活地在自己的 CMS 中管理您的內容，並使用自訂安全性結構描述傳遞內容。

這對於擁有現有架構且在需要資訊清單 URL 之前不允許播放 API 呼叫的客戶而言，這非常重要。播放器也可以使用此功能，減少播放開始時間，通過消除一次通話。

另請參閱播放 API v2 參考。

需求

靜態 URL 需要下列需求：

  • 亮灣播放 API 第 2 版
  • 您的資產會內嵌進行動態交付

分析註冊

使用靜態 URL 時，您可以在不使用 Brightcove 播放程式的情況下與播放 API 整合。雖然布萊特灣播放器會自動將分析資料傳送至布萊特灣，但您將使用資料收集 API 來執行此動作。

如果您不熟悉資料收集 API，請檢閱概觀：資料收集 API 文件。

如需有關傳送資訊給資料收集器的詳細資訊，請參閱資料收集 API 範例。

Video Cloud

今天，每次透過視訊雲播放都需要 2 次 API 呼叫才能開始播放視訊。使用靜態 URL，您可以將 API 呼叫的數目減少為一個。

下圖顯示了沒有靜態 URL 的視頻播放 API 調用。

視訊雲端播放
視訊雲端播放

靜態網址

使用布萊特灣的播放 API v2，現在可以使用靜態網址。

功能

以下是與靜態 URL 相關的功能：

功能 註解
隨選視訊 (VOD) 僅透過動態傳遞支援的視訊格式：
  • HLS
  • 破折號
  • HLS 虛擬映射
  • 虛線虛擬對應
  • MP4
VOD 資產 縮圖和海報影像
授權 網頁權杖 (JWT)
DRM 僅限點播
傳送規則 僅限點播
伺服器端廣告插入 (SSAI) VOD 與即時影片
自帶CDN 布萊特灣的 CDN 將繼續提供清單和分列艙單。

客戶的 CDN 只會提供視訊區段。
隱藏字幕 目前僅支援資訊清單內註解。
播放權限服務 (EPA) 如需詳細資訊，請聯絡客戶經理。
傳送規則 僅限點播

實作靜態 URL

靜態 URL 包括以下內容：

  • 帳戶 ID
  • 視訊 ID (或參考資料)
  • 傳送類型 (HLS、破折號)
  • 組態選項 (SSAI、DRM、CDN 等)

靜態URL由客戶生成並簽名保護JSON Web Token（JWT）。使用此權杖，您可以設定並強制執行傳遞的各個層面。如需詳細資訊，請參閱建立JSON Web Token區段。

域

用於靜態網址的網域是播放 API v2 (PapiV2) 網址： 

https://edge.api.brightcove.com/playback/v1/

端點

每種傳送類型的靜態 URL 範例：

HLS 主資訊清單
/accounts/{account_id}/videos/{video_id}/master.m3u8?bcov_auth={jwt}
破折號清單
/accounts/{account_id}/videos/{video_id}/manifest.mpd?bcov_auth={jwt}
HLS 虛擬圖 [1-1] 
/accounts/{account_id}/videos/{video_id}/hls.vmap?bcov_auth={jwt}
虛線虛擬圖 [1-1] 
/accounts/{account_id}/videos/{video_id}/dash.vmap?bcov_auth={jwt}
最高位元速率 MP4
/accounts/{account_id}/videos/{video_id}/high.mp4?bcov_auth={jwt}
最低位元速率 MP4
/accounts/{account_id}/videos/{video_id}/low.mp4?bcov_auth={jwt}
縮略圖
/accounts/{account_id}/videos/{video_id}/thumbnail.jpg?bcov_auth={jwt}
海報圖片
/accounts/{account_id}/videos/{video_id}/poster.jpg?bcov_auth={jwt}

注意事項

  • [ 1-1] 只有在建立 JWT 時包含ssai宣告時才能擷取 HLS 和 DASH vMap-請參閱下一節。

查詢參數

查詢參數
查詢參數 價格
bcov_auth JWT 請參閱下面

建立JSON Web Token

若要建立與 Brightcove 播放 API 通訊時使用的權杖，請參閱建立JSON Web Token (JWT) 文件。您會在那裡找到可用於靜態 URL 傳遞的宣告。

使用內容保護 (DRM)

如上所定義，您可以包含pro宣告來指定保護類型。

對於許可證請求，JWT 不需要任何有效載荷，但必須使用與清單請求 JWT 相同的 RSA 密鑰進行簽名。

威德維恩許可申請

您可以使用以下端點取得 Widevine 的 DRM 許可證： 

/accounts/{account_id}/videos/{video_id}/licenses/cenc/widevine?bcov_auth={JWT}

應用程式證書

對於 FairPlay 應用程式憑證，端點為： 

/accounts/{account_id}/fairplay_app_cert

播放就緒端點

對於 PlayReady，授權要求的端點為：

/accounts/{account_id}/videos/{video_id}/licenses/cenc/playready?bcov_auth={JWT}

注意事項

下列注意事項適用於靜態 URL 傳遞：

  • 支援資訊清單內註解。未來版本將支援頻外附屬字幕。
  • 客戶的 BYO CDN 將提供視頻段，而布萊特灣的 CDN 將繼續提供清單和子清單。
  • 布萊特灣支持使用不會過期的 JWT。為此，請排除exp創建令牌時聲明。