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

遠程資產

在本主題中,您將學習如何將遠程資源(包括視頻,字幕,清單,圖像和WebVTT文本軌道)添加到 Video Cloud 使用 CMS API。 本主題說明如何設置視頻,然後添加,更新和刪除遠程資產。

概述

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

授權

工作流程

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

遠程資產工作流程
遠程資產工作流程

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

創建視頻

您必須先在自己的視頻中創建一個視頻對象,然後才能添加遠程資產 Video Cloud 媒體庫,使用POST請求執行以下操作:

      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": "//learning-services-media.brightcove.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)中顯示此信息 player,如果您配置 player 以顯示元數據)。

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

  3. 遠程資產的副本必須具有 video_codec video_container 字段正常工作。
  4. MP4格式 必須的,"progressive_download": true 字段設置為在Brightcove中正常工作 player
  5. 不允許使用混合資產-您無法向提取的視頻添加遠程演繹
  6. 如果您的CDN或其他遠程存儲庫同時支持HTTP和HTTPS傳遞,則請使用 與協議無關的網址 如上例所示(即使用“ //my.domain/path / ...”而不是“ http://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": "http://learning-services-media.brightcove.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": "http://learning-services-media.brightcove.com/images/great-blue-heron-poster.png"
      }
      
      

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

添加文字軌道

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

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

用攝取的代替遙控器

您可以通過向請求的 Dynamic Ingest API:

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

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

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

看到 Dynamic Ingest API 參考 有關其他選項和信息。

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

修改資產

除了為視頻添加遠程資產外,還存在用於檢索,更新和刪除資產信息的操作。 這些操作使用上述端點,但使用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參考 有關獲取,更新和刪除操作的詳細信息。


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