靜態 URL 傳送

簡介

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

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

另見播放 API v2 參考 .

需求

靜態 URL 需要下列需求：

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

分析註冊

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

如果您不熟悉數據收集 API，請查看概述：數據收集接口文檔。

有關向數據收集器發送信息的詳細信息，請參閱數據收集 API 示例 .

Video Cloud

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

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

靜態網址

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

功能

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

實作靜態 URL

靜態 URL 包括以下內容：

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

靜態 URL 使用客戶生成並簽名的JSON Web Token（智威湯遜）。使用此權杖，您可以設定並強制執行傳遞的各個層面。有關詳細信息，請參閱創建一個JSON Web Token部分。

域

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

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

查詢參數

視頻點播 (VOD) 端點

每種傳送類型的靜態 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 VMAP ^[1]

/accounts/{account_id}/videos/{video_id}/hls.vmap?bcov_auth={jwt}

破折號 VMAP ^[1]

/accounts/{account_id}/videos/{video_id}/dash.vmap?bcov_auth={jwt}

最高比特率 MP4 ^[2]

/accounts/{account_id}/videos/{video_id}/high.mp4?bcov_auth={jwt}

最低比特率 MP4 ^[2]

/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] HLS 和 DASH VMAP 只能在包含ssai當你索賠創建智威湯遜 .
• ^[2]當使用high.mp4和low.mp4端點，您的視頻必須包含 MP4 格式，否則您將收到以下錯誤：

  404 (NO RESOURCE)

實時端點

直播流的靜態 URL 示例：

HLS 主資訊清單

/accounts/{account_id}/videos/{video_id}/master.m3u8?bcov_auth={jwt}

HLS VMAP ^[1]

/accounts/{account_id}/videos/{video_id}/hls.vmap?bcov_auth={jwt}

注意事項

• ^[1]只有包含以下內容才能檢索 HLS VMAP ssai當你索賠創建智威湯遜 .

創建一個JSON Web Token

要創建與 Brightcove 的播放 API 通信時使用的令牌，請參閱創建一個JSON Web Token (智威湯遜)文檔。您會在那裡找到可用於靜態 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創建令牌時聲明。