支持 聯繫支持 | 系統狀況 系統狀態

靜態網址傳遞

在本主題中,您將學習如何使用Brightcove中的靜態URL Playback API v2。

簡介

Brightcove為您的資產中的視頻清單文件提供靜態URL Video Cloud 圖書館。 這使您可以靈活地在自己的CMS中管理您的內容,並使用自定義安全模式進行交付。

這對於擁有現有架構但不允許 Playback API 在需要清單網址之前調用。 的 player 也可以使用此功能,通過消除一個呼叫來減少播放開始時間。

要求

靜態URL需要滿足以下要求:

帳戶設定

要簽署JSON Web令牌(JWT),需要為您的Brightcove帳戶啟用播放授權服務。 請與您的客戶經理聯繫以完成此操作。

分析註冊

使用靜態網址,您可以與 Playback API 不使用 Brightcove Player。 雖然 Brightcove Player 自動將分析數據發送到Brightcove,您將使用 Data Collection API 去做這個。

如果你不熟悉的話 Data Collection API,查看 概述: Data Collection API 文件。

有關將信息發送到數據收集器的詳細信息,請參見 Data Collection API 樣本.

Video Cloud

今天,通過VideoCloud進行的每次播放都需要2個API調用才能開始視頻播放。 通過使用靜態URL,您可以將API調用的數量減少到一個。

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

Video Cloud 播放
Video Cloud 播放

靜態網址

隨著Brightcove的 Playback API v2,現在可以使用靜態URL。

設備

以下是與靜態網址相關聯的功能:

獨特之處 留言
對VOD的靜態URL支持 僅通過動態投放支持的視頻格式:
  • HLS
  • 短跑
  • HLS VMAP
  • 短跑VMAP
授權 JSON Web令牌(JWT)
DRM 僅限VOD
服務器端廣告插入(SSAI) 僅限VOD
自帶CDN Brightcove的CDN將繼續提供清單和子清單。

客戶的CDN將僅提供視頻片段。
隱藏式字幕 當前僅支持清單內字幕。

實施靜態網址

靜態URL包括以下內容:

  • 帳戶ID
  • 影片ID(或參考)
  • 投放類型(HLS,破折號)
  • 配置選項(SSAI,DRM,CDN等)

這些URL使用客戶生成並簽名的JSON Web令牌(JWT)進行保護。 使用此令牌,您可以配置和實施交付方面。 有關詳細信息,請參見 創建一個JSON Web令牌 部分。

用於靜態網址的域是 Playback API v2(PAPIv2)URL:

https://playback.brightcovecdn.com/playback/v1/

端點

每種投放類型的靜態網址示例:

交貨類型 網址
HLS主清單
/accounts/{account_id}/videos/{video_id}/master.m3u8?bcov_auth={jwt}
DASH清單
/accounts/{account_id}/videos/{video_id}/manifest.mpd?bcov_auth={jwt}
HLS VMAP
/accounts/{account_id}/videos/{video_id}/hls.vmap?bcov_auth={jwt}
短跑VMAP
/accounts/{account_id}/videos/{video_id}/dash.vmap?bcov_auth={jwt}

創建一個JSON Web令牌

創建與Brightcove的通信時使用的令牌 Playback API,請參閱 創建一個JSON Web令牌(JWT) 文件。

靜態網址傳遞聲明

以下聲明可與Brightcove的靜態URL傳遞一起使用。

類型 需要的 產品描述
accid 擁有正在播放的內容的帳戶ID
exp 整型 自時代以來的秒數,此令牌不再有效的時間。 距離日期不得超過30天 iat
iat 整型 此令牌發布的時間(自大紀元以來的秒數)
conid 如果存在,此令牌將僅授權獲取特定許可證 Video Cloud 影片ID。

必須是有效的視頻ID。
pro 在單個視頻有多個可用保護的情況下,指定保護類型。

價值觀:
  • “”(清除內容的默認值)
  • “ aes128”
  • “寬闊的藤蔓”
  • “準備好了”
  • “公平競爭”
vod 對象 包含“視頻點播”的特定配置選項。
ssai 您的服務器端廣告插入(SSAI)配置ID。

這是您可能使用的JSON Web令牌(JWT)聲明的示例:

{
        // account id: JWT is only valid for this accounts
        "accid":"4590388311111",
        // expires: timestamp when JWT expires
        "exp":1577989732,
        // issued at: timestamp when the JWT was created
        "iat":1575484132,
        // content id: JWT is only valid for video id or reference id
        "conid":"5805807122222",
        // protection: specify a protection type in the case where multiple are available for a single video
        "pro":"aes128",
        // VOD specific configuration options
        "vod":{
          // SSAI configuration to apply
          "ssai":"efcc566-b44b-5a77-a0e2-d33333333333"
        }
      }

使用內容保護(DRM)

您可以包括 pro 如上所定義,要求指定保護類型。

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

許可請求

您可以使用以下端點獲取DRM許可證:

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

的有效值 scheme:

  • “寬闊的藤蔓”
  • “準備好了”
  • “公平競爭”

FairPlay應用程序證書

對於FairPlay應用程序證書,端點為:

/accounts/{account_id}/fairplay_app_cert

筆記

以下說明適用於靜態URL傳遞。

  • 支持清單內字幕。 將來的版本將支持帶外Sidecar字幕。
  • 客戶的BYO CDN將提供視頻片段,而Brightcove的CDN將繼續提供清單和子清單。
  • Brightcove確實支持使用永不過期的JWT。 為此,請勿包括 exp 創建令牌時聲明。

限制

以下限制適用於靜態URL傳遞。

  • Live 在更高的版本中將支持流。
  • 在更高的版本中將支持MP4。
  • 更高版本中將支持傳遞規則。

頁面最後更新於12年2020月XNUMX日