支持 聯繫支持 | 系統狀況 系統狀態
頁面內容

    概述: Dynamic Ingest API

    在本主題中,您將學習如何使用 Dynamic Ingest API 上傳和管理視頻內容。

    API功能

    Brightcove的動態提取(DI)API基於功能,在該功能中,從客戶的存儲位置下載了視頻源文件,並創建了源文件的指定格式。 (也可以選擇 上傳您的源文件 平台以雲為中心,在全球範圍內分佈,並基於現代實踐提供一流的一致性和速度。

    工作流程概述

    在媒體的整體轉碼和存儲中使用了許多系統/技術。 他們是:

    • 內容管理系統(CMS)API:創建在DI API中使用的視頻對象
    • Zencoder:對視頻進行轉碼,以創建多個演繹版本
    • 亞馬遜S3:根據配置文件設置將母版和演繹圖移至存儲
    • 產品系列:存儲與視頻相關的必要信息

    初始轉碼後,您可以在媒體上執行以下操作:

    • 重新轉碼:存在母版時創建新的演繹(如果不存在母版則出錯)
    • 更換:指向新的母版,或替換現有的母版

    操作

    使用DI API時,您將執行不同的操作,例如讀取摘要配置文件並將摘要信息寫入您的帳戶。 以下是DI任務所需的完整操作列表:

    • 視頻雲/視頻/創建
    • 視頻雲/視頻/閱讀
    • 視頻雲/視頻/更新
    • video-cloud / ingest-profiles / profile / read
    • video-cloud / ingest-profiles /帳戶/讀取
    • video-cloud / ingest-profiles / account / write
    • video-cloud / ingest-profiles / profile / write
    • video-cloud / upload-urls / read

    要獲取客戶端憑據,請使用Studio 管理工具 或查看以下文件之一:

    最佳實踐

    有效的來源位置

    Dynamic Ingest可以從以下來源提取源視頻文件:HTTP / HTTPS或S3-帶有或不帶有身份驗證

    例子:

    • http://example.com/path/to/input.avi
    • https://dl.dropboxusercontent.com/u/3641457/Bird_Titmouse.mp4
    • s3://my-bucket/video.mp4

    關於S3的注意事項

    如果您的視頻位於受保護的S3存儲桶中,請參見 在S3上使用動態攝取 有關如何設置“動態提取”訪問文件權限的詳細信息。

    使用基於拉取的攝取的優點包括更簡單的工作流程以及擁有自己的數字母版的存儲庫。 但是,如果這不是您的選擇,則也可以使用 源文件上傳 將您的視頻和其他資產上傳到Dynamic Ingest可以訪問它們的臨時位置。

    源文件名

    所有輸入網址必鬚根據以下內容正確編碼 RFC 3986 當發送到Brightcove時。 這意味著任何 保留字 在網址路徑中找到的是百分比編碼(空格被編碼為 %20),並且在網址查詢中找到的所有保留字符均按百分比編碼(空格被編碼為 + or %20+ 被編碼為 %2B).

    A 預簽 S3(v2 包含 簽名, 過期AWSAccessKeyIdv4 包含 X-Amz-算法, X-Amz憑證, X-Amz-Date, X-Amz到期, X-Amz簽名的標頭X-Amz簽名)或 GCS (包含 簽名, 過期GoogleAccessId)網址應已正確編碼,並且 可以原樣使用.

    攝取視頻

    攝取視頻需要兩個API調用:

    1. 調用 CMS API 在中創建視頻對象 Video Cloud 系統並獲取其ID
    2. 調用DI API以提供視頻源文件的URL並指定 攝取個人資料 要使用的

    一組基本請求示例如下所示:

    CMS API 請求

    HTTP方法
    POST
    要求網址
    https://cms.api.brightcove.com/v1/accounts/{account_id}/videos
    請求正文
        {
        "name": "My new video"
        }
        
        

    響應數據將包括視頻 id ,在下一個請求中使用。

    提取API請求

    HTTP方法
    POST
    要求網址
    https://ingest.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/ingest-requests
    請求正文
        {
        "master": {
        "url": "http://host/master.mp4"
        },
        "profile": "high-resolution"
        }
        
        

    看到 快速啟動 有關API調用的詳細信息,您還可以看到一個 工作樣本.

    為 CMS API 呼叫以在 Video Cloud 系統,請參閱 CMS API 概述。 請注意,視頻 name 是必需的,並且名稱和視頻元數據中包含的任何其他字符串(例如 description ) 必須使用URI編碼.

    樣本資產

    Brightcove學習服務提供了一些示例資產,您可以使用這些資產來試用Dynamic Ingest。 這些資產包括多種語言的簡短視頻,圖像和WebVTT字幕:

    替換視頻

    要用新版本或新的再現形式替換視頻, Dynamic Ingest API 通話完全相同 攝取新視頻 -唯一的區別是您無需事先致電 CMS API 在中創建視頻對象 Video Cloud 系統並為其獲取ID。 如果指定URL上的源視頻文件與原始攝取的源視頻文件相同,則您將僅獲得一組新的格式。 如果源文件是新文件,則將替換現有視頻。 在重新轉碼完成之前,所有視頻都可以使用現有的副本播放。

    看到 這裡的工作樣本.

    重新轉換視頻

    如果您選擇 存檔大師 當您通過 Dynamic Ingest API 或Studio上傳模塊,那麼您也可以重新轉換主視頻。 再次,提取請求的URL將相同,但是請求主體將具有以下內容:

        // request
        POST /v1/accounts/{account_id}/videos/{video_id}/ingest-requests
        // request body
        {
        "master": { "use_archived_master": true },
        "profile": "videocloud-default-v1"
        }
        
        

    圖片

    您可以使用 Dynamic Ingest API 從視頻中捕獲海報和縮略圖圖像,或添加自己的圖像。 有關詳細信息,請參見 圖片和 Dynamic Ingest API.

    攝取字幕

    您還可以將WebVTT字幕添加到視頻中,或使用Dynamic Ingest為現有視頻上傳它們。 有關詳細信息,請參見 提取WebVTT文件.

    DRM和HLSe

    Dynamic Ingest可處理使用Brightcove支持的任何DRM類型的視頻。 還支持HLSe。

    存檔渲染

    默認情況下,所有視頻和圖像片段都會自動存檔。 如果您想關閉移交存檔, 聯繫Brightcove支持。 注意 數字大師 如果在攝取配置文件中指定,則將存檔。

    通知

    您可以指定一個或多個回調URL,以接收有關提取過程結果的通知。 您指定的URL應該是針對可以接受POST請求的應用程序的。 通知將以JSON格式發送。

    有關接收和解釋通知的詳細信息,請參見 通知:動態提取和 CMS APIs


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