概覽
遠程資產主要通過資產運作，以下有一些例外。請注意，資產的GET操作可用於提取的資產和遠程資產。
授權
工作流程
以下是設置遠程資產的步驟：
在以下各節中，我們將研究每個步驟。
創建視頻
必須先使用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
}
注意事項
- 僅將此端點用於添加完整長度的視頻副本（通常是.mp4或.mov文件）-用於添加分段流（例如HLS或DASH），請使用下一節中介紹的清單端點。
-
Video Cloud不會檢查遠程視頻文件，因此提供其他元數據將使Video Cloud能夠在Studio（或Brightcove播放器，如果將播放器配置為顯示元數據）中顯示此信息。
有關添加再現操作的詳細信息，請參見API參考。
- 遠程資產的副本必須具有
video_codec和video_container字段正常工作。 - MP4格式必須有
"progressive_download": true字段設置為在Brightcove播放器中正常工作 - 不允許使用混合資產-您無法向提取的視頻添加遠程演繹
- 如果您的 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參考有關獲取，更新和刪除操作的詳細信息。