遠端資產

在本主題中,您將學習如何使用 CMS API 將遠端資產 (包括視訊、轉譯、資訊清單、影像和 WebVTT 文字軌跡) 新增至視訊雲端。本主題說明如何設定視訊,然後新增、更新及移除遠端資產。

概覽

遠程資產主要通過資產運作,以下有一些例外。請注意,資產的GET操作可用於提取的資產和遠程資產。

授權

工作流程

以下是設置遠程資產的步驟:

<img class =“ bcls-image--no-border” alt =“遠程資產工作流” src =“ / assets / images / cms / managing-videos / remote-assets-workflow.svg”“ />
遠程資產工作流程

在以下各節中,我們將研究每個步驟。

創建視頻

必須先使用POST請求在Video Cloud媒體庫中創建視頻對象,然後才能添加遠程資產:

      https://cms.api.brightcove.com/v1/accounts/{account_id}/videos
      
      

在請求正文中,包括一個JSON對象,該對象最少包含視頻名稱,但可能包含其他元數據:

      {
        "name": "My Remote Video",
        "description": "A short description of the video",
        "tags": ["remote", "fall_campaign"],
        "reference_id": "myUniqueReferenceID"
      }
      
      

有關創建視頻操作的詳細信息,請參見API參考

添加渲染

接下來,通過向以下地點發出POST請求來添加一個或多個全長遠程視頻副本:

      https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/renditions
      
      

請求正文中的JSON必須至少包含遠程url,但可能包含用於呈現的其他元數據:

      {
        "video_duration": 31487,
        "name": "RA - Great Blue Heron",
        "remote_url": "//some.site.com/videos/mp4/greatblueheron.mp4",
        "encoding_rate": 983000,
        "frame_height": 360,
        "size": 3887659,
        "frame_width": 640,
        "video_codec": "h264",
        "video_container": "MP4",
        "progressive_download": true
      }
      
      

注意事項

  1. 僅將此端點用於添加完整長度的視頻副本(通常是.mp4或.mov文件)-用於添加分段流(例如HLS或DASH),請使用下一節中介紹的清單端點。
  2. Video Cloud不會檢查遠程視頻文件,因此提供其他元數據將使Video Cloud能夠在Studio(或Brightcove播放器,如果將播放器配置為顯示元數據)中顯示此信息。

    有關添加再現操作的詳細信息,請參見API參考

  3. 遠程資產的副本必須具有video_codec video_container 字段正常工作。
  4. MP4格式必須"progressive_download": true 字段設置為在Brightcove播放器中正常工作
  5. 不允許使用混合資產-您無法向提取的視頻添加遠程演繹
  6. 如果您的 CDN 或其他遠程存儲庫同時支持 HTTP 和 HTTPS 傳輸,則使用 協議中立 URL 指定遠程資產的 URL,如上例所示(即使用“//my.domain/path/...”代替) “https://my.domain/path/...”)

添加清單

請注意,要添加遠程分段類型(例如DASH和HLS再現),只需創建視頻,然後添加清單-您可以如上一節所述,需要“添加演繹”。

除了添加完整格式,您還可以通過向清單類型的端點發出POST請求,為分段格式(例如HLS,HDS和ISM)添加清單。

      https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/hls_manifest
      https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/hds_manifest
      https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/ism_manifest
      https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/ismc_manifest
      https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/dash_manifests
      
      

在請求正文JSON中,提供遠程URL和名稱(可選):

      {
        "remote_url": "https://some.site.com/avideo/hls/chickadee/chickadee.m3u8",
        "name": "chickadee_hls"
      }
      
      

有關使用添加清單操作的詳細信息,請參閱API參考的相關部分:

添加海報/縮略圖

您可以通過向以下端點發出POST請求,將遠程海報和縮略圖添加到視頻中:

      https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/poster
      https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/thumbnail
      
      

在請求正文JSON中,必須包含圖像的遠程URL,並且您可以根據需要添加名稱:

      {
        "remote_url": "https://some.site.com/images/great-blue-heron-poster.png"
      }
      
      

有關操作的詳細信息,請參閱API參考:

添加文字軌道

文本軌道可用於向視頻添加字幕,章節和其他基於時間的元數據。

與呈現和圖像不同,遠程資產視頻的文本軌道與攝取到視頻雲系統中的視頻相同。要將文本軌道實際添加到視頻中,必須使用Studio中的“媒體”模塊或CMS API更新視頻操作

用攝取的代替遙控器

您可以通過向Dynamic Ingest API發出請求,將一個遠程資產視頻替換為一個已攝取的視頻:

      https://ingest.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/ingest-requests
      
      

最簡單的請求正文如下所示:

      {
        "master": {
          "url": "https://host/master.mp4"
        }
      }
      
      

動態提取API參考有關其他選項和信息。

遠程資產視頻的常見用途之一是創建用於現場直播事件的佔位符視頻。事件完成後,您可能希望將事件的視頻點播記錄替換為“實時”視頻,該視頻出現在用於實時流的同一播放器中。您也可以使用上述方法來執行此操作,儘管它也可以用於將任何遠程資產視頻轉換為視頻雲中的視頻。

修改資產

除了為視頻添加遠程資產外,還存在用於檢索,更新和刪除資產信息的操作。這些操作使用上述端點,但使用GET,PATCH或DELETE請求。對於更新和刪除請求,必須將資產ID(包含在POST和GET請求的響應中)添加到請求URL:

      https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/{asset_type}/{asset_id}
      
      

API參考有關獲取,更新和刪除操作的詳細信息。

限制

  • 遠端資產不支援 SSAI。
  • 只有當您可以自訂播放程式以與 DRM 授權伺服器通訊時,才支援 DRM。這是可以通過插件的布萊特灣播放器。對於其他玩家,您需要查閱播放程式文件。
  • 分析:Brightcove Analytics 系統取決於系統產生的視訊中繼資料,例如視訊持續時間。除非您可以為遠端資產提供此中繼資料,否則遠端資產的分析資料將會較不豐富。
  • 播放保證:所有攝錄到視頻雲端的視頻都可以在布萊特灣播放器中播放。幾乎所有的遠端資產都是如此,但在某些邊緣情況下,影片可能無法播放。例如,我們尚未支援 DASH 和 HLS 的一些進階功能。對於非 BrightCove 播放器,您必須確認該播放器是否完全支援視訊格式。