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

    概述: Dynamic Ingest API

    在本主題中,您將學習如何使用 Dynamic Ingest API 攝取視頻,以便可以通過動態投放進行投放。 請注意,本指南適用於大多數 Video Cloud 動態投放提取系統上的帳戶。 那些帳戶仍舊在舊版提取系統上的帳戶應轉到 Dynamic Ingest API 舊版代替。

    簡介

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

    另見 API參考.

    工作流程概述

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

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

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

    操作

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

      • video-cloud/video/create
      • video-cloud/video/read
      • video-cloud/video/update
      • video-cloud/ingest-profiles/profile/read
      • video-cloud/ingest-profiles/account/read
      • video-cloud/ingest-profiles/account/write
      • video-cloud/ingest-profiles/profile/write
      • video-cloud/upload-urls/read

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

    最佳實踐

    看到 動態提取API:最佳做法.

    有效的來源位置

    基於拉取的攝取

    Dynamic Ingest可以從HTTP / HTTPS,S3和FTP中提取源視頻文件-帶有或不帶有身份驗證

    例子:

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

    關於S3的注意事項

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

    FTP注意事項

    如果您的視頻位於受保護的FTP服務器中,請使用標準方法在URL上傳遞用戶名和密碼,如下所示:

        ftp://username:password@server/file.mp4

    源文件上傳

    您還可以將文件上傳到安全的臨時位置,Dynamic Ingest可以從該位置將其提取。 有關詳細信息,請參見 源文件上傳.

    特殊字符

    如果您提供的網址是 Video Cloud 來獲取視頻,並且您正在發送憑據作為URL的一部分,你需要 百分比編碼 某些保留的特殊字符:

    特殊字符
    多元錶款系列 百分比編碼
    ] %5B
    [ %5D
    ? %3F
    / %2F
    < %3C
    ~ %7E
    # 23%
    ` %6D
    ! 21%
    @ 40%
    $ 24%
    % 25%
    ^ %5E
    - 26%
    * %2A
    ( 28%
    ) 29%
    + %2B
    = %3D
    } %7D
    | %7C
    : %3A
    " 22%
    ; %3B
    ' 27%
    , %2C
    > %3E
    { %7B
    空間 20%

    例如:

        
            /* unencoded */
            ftp://user@example.com:pass!word@example.com/path/to/input.mp3
        
            /* encoded */
            ftp://user%40example.com:pass%21word@example.com/path/to/input.mp3
          

    源文件名

    所有輸入網址必鬚根據以下內容正確編碼 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)網址應已正確編碼,並且 可以原樣使用.

    樣本資產

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

    攝取個人資料

    創建動態投放視頻需要特殊的攝取配置文件。 您會發現幾個 標準攝取檔案 啟用“動態投放”後,您的帳戶中會顯示“建議”。

    您還可以在Studio的“管理”部分中將自定義動態投放配置文件添加到您的攝取配置文件-請參閱 創建用於動態交付的摘要配置文件 有關詳細信息。

    樣本動態投放資料

    以下是一個示例動態交付配置文件,可用於入門。 您需要做的就是更換 YOUR_ACCOUNT_ID 使用您的帳戶ID,然後您可以將配置文件複製並粘貼到攝取配置文件編輯器中。

        {
          "name": "DynamicDeliveryIngestProfile",
          "description": "Dynamic Delivery ingest profile.",
          "account_id": "YOUR_ACCOUNT_ID",
          "digital_master": {
            "rendition": "passthrough",
            "distribute": false
          },
          "dynamic_origin": {
            "renditions": [
              "default/audio64",
              "default/audio96",
              "default/audio128",
              "default/video450",
              "default/video700",
              "default/video900",
              "default/video1200",
              "default/video1700",
              "default/video2000"
            ],
            "images": [
              {
                "label": "poster",
                "height": 720,
                "width": 1280
              },
              {
                "label": "thumbnail",
                "height": 90,
                "width": 160
              }
            ]
          }
        }
        

    有關標準動態投放配置文件和格式轉換的詳細信息,請參見 用於動態投放的標準攝取配置文件

    攝取視頻

    攝取視頻需要兩個API請求:

    1. 調用 CMS API 在中創建視頻對象 Video Cloud 系統並獲取其ID
    2. 調用 Dynamic Ingest API 提供視頻源文件的URL,並根據需要指定其他文件和設置以進行提取

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

    CMS API 請求

    HTTP方法
    POST
    要求網址
    https://cms.api.brightcove.com/v1/accounts/{account_id}/videos
    請求正文
        {
        "name": "My First Dynamic Delivery 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": "DynamicDeliverIngestProfile",
          "callbacks": [
            "http://mydomain.com/di-callbacks.php"
          ]
        }
        

    筆記

    • 如果您不包括 profile 字段,將使用該帳戶默認配置文件。 我們建議您使用默認帳戶,除非您需要為不同類型的視頻使用不同的配置文件。 確保將帳戶默認設置為您(最常使用)的配置文件。
    • callbacks 字段是可選的,但我們強烈建議您將其用作跟踪提取作業進度的最佳方法。 看到 下面 有關通知的更多信息。

    查看渲染

    您可以通過以下方法查看視頻的演繹版本: Studio中的媒體模塊.

    要查看格式副本的完整屬性,可以使用 CMS API 詳細要求如下.

    要檢索要播放的網址,您可以使用 Playback API 詳細要求如下.

    替換視頻

    要用新版本或新的再現形式替換視頻, 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": "multi-platform-extended-static"
        }
        
        

    圖像攝取

    您可以在提取請求中包含自己的圖像,也可以稍後在單獨的請求中添加它們,而不必在轉碼過程中捕獲海報和縮略圖圖像。

    樣品申請機構

        {
          "profile": "multi-platform-extended-static",
          "poster": {
            "url": "http://bcls@solutions.brightcove.com/bcls/assets/images/great-blue-heron-poster.png",
            "width": 1280,
            "height": 720
          },
          "thumbnail": {
            "url": "http://bcls@solutions.brightcove.com/bcls/assets/images/great-blue-heron-thumbnail.png",
            "width": 160,
            "height": 90
          },
          "callbacks": [
            "http://solutions.brightcove.com/bcls/di-api/di-callbacks.php"
          ]
        }
        

    圖像資產提取通知

    以下是專門為圖像攝取而獲得的通知示例。

        {
            "entity": "thumbnail",
            "entityType": "ASSET",
            "version": "1",
            "action": "CREATE",
            "jobId": "0c2767c1-19ea-479d-b371-a0f5f3d154f5",
            "videoId": "5209530177001",
            "accountId": "57838016001",
            "status": "SUCCESS"
          }
          {
            "entity": "poster",
            "entityType": "ASSET",
            "version": "1",
            "action": "CREATE",
            "jobId": "0c2767c1-19ea-479d-b371-a0f5f3d154f5",
            "videoId": "5209530177001",
            "accountId": "57838016001",
            "status": "SUCCESS"
        }
        
        

    字幕攝取

    可以將WebVTT格式的字幕與初始攝取請求或以後的請求一起添加到視頻中。

    樣品申請機構

        {
          "text_tracks": [
            {
              "url": "http://solutions.brightcove.com/bcls/assets/vtt/sample.vtt",
              "srclang": "en",
              "kind": "captions",
              "label": "EN",
              "default": true
            },
            {
              "url": "http://solutions.brightcove.com/bcls/assets/vtt/sample-es.vtt",
              "srclang": "es",
              "kind": "captions",
              "label": "ES",
              "default": false
            }
          ],
          "callbacks": [
            "http://solutions.brightcove.com/bcls/di-api/di-callbacks.php"
          ]
        }
        

    與非動態投放視頻一樣,Sidecar文本軌道將顯示在CMS或播放響應中:

        "text_tracks": [
            {
            "id": null,
            "src": "https://bcbolt446c5271-a.akamaihd.net/media/v1/text/vtt/clear/57838016001/3de8c552-74e8-4c53-aa11-2a4375edf658/bce0d3dc-11d9-4ca4-ae1b-a39cb7b88a1c/text.vtt?akamai_token=exp=1479236791~acl=/media/v1/text/vtt/clear/57838016001/3de8c552-74e8-4c53-aa11-2a4375edf658/bce0d3dc-11d9-4ca4-ae1b-a39cb7b88a1c/text.vtt*~hmac=df5b4ba1ef2549a7572346dd36a761534ffafe4b8cfbdf92d89013ec2f95699c",
            "srclang": "en",
            "label": "EN",
            "kind": "captions",
            "mime_type": "text/webvtt",
            "asset_id": null,
            "sources": [
              {
              "src": "https://bcbolt446c5271-a.akamaihd.net/media/v1/text/vtt/clear/57838016001/3de8c552-74e8-4c53-aa11-2a4375edf658/bce0d3dc-11d9-4ca4-ae1b-a39cb7b88a1c/text.vtt?akamai_token=exp=1479236791~acl=/media/v1/text/vtt/clear/57838016001/3de8c552-74e8-4c53-aa11-2a4375edf658/bce0d3dc-11d9-4ca4-ae1b-a39cb7b88a1c/text.vtt*~hmac=df5b4ba1ef2549a7572346dd36a761534ffafe4b8cfbdf92d89013ec2f95699c"
              }
            ],
            "in_band_metadata_track_dispatch_type": "",
            "default": false
          ]
        }
        

    文本軌道還將顯示在HLS和DASH清單中:

    HLS

        #EXT-X-MEDIA:TYPE=SUBTITLES,GROUP-ID="subtitles-0",NAME="Captions",DEFAULT=NO,AUTOSELECT=YES,LANGUAGE="es",URI="https://manifest.prod.boltdns.net/manifest/v1/hls/v5/clear/57838016001/1bd49b7b-df40-414f-bb05-8840624663e1/de8144f4-b7d7-46ca-848f-dd2f7fa453d7/rendition.m3u8?fastly_token=NTg0ZjA5MWZfMzU1N2VhY2Y2MDA3NzkzYWM0ZjU2ZWQwNWE2NTYzMmI4MzMzMmJkZWM5Y2JmNzQ1MjRjM2QxYjI0NTYzODA5Zg%3D%3D"
        #EXT-X-MEDIA:TYPE=SUBTITLES,GROUP-ID="subtitles-0",NAME="Captions",DEFAULT=NO,AUTOSELECT=YES,LANGUAGE="en",URI="https://manifest.prod.boltdns.net/manifest/v1/hls/v5/clear/57838016001/1bd49b7b-df40-414f-bb05-8840624663e1/6399fcf2-cd27-4d97-ad30-e443f13563bd/rendition.m3u8?fastly_token=NTg0ZjA5MWZfYWMxYjllNDlkYzVlOTJkZWQ3ODk2YjE3MGI5NDlhYTlkOGQ1YzI5ZmI4ZjRlOWMzMzU5YmM1YzZkNTA4MTFmNQ%3D%3D"
        
        

    短跑

        <AdaptationSet mimeType="text/vtt" lang="en">
          <Representation bandwidth="256" id="2f4bb3fb-1a7d-4f4c-bf44-00ef0e611131">
          <BaseURL>https://bcbolt446c5271-a.akamaihd.net/media/v1/dash/live/clear/57838016001/785d5ddf-6672-4ece-9191-d105445b2557/2f4bb3fb-1a7d-4f4c-bf44-00ef0e611131.vtt?akamai_token=exp=1484784452~acl=/media/v1/dash/live/clear/57838016001/785d5ddf-6672-4ece-9191-d105445b2557*~hmac=ae568ea5294280968de0a2766afd82922ea9aa83fe23a81b3379a46b8ef13284</BaseURL>
          </Representation>
          </AdaptationSet>
          <AdaptationSet mimeType="text/vtt" lang="hi">
          <Representation bandwidth="256" id="f5875617-40f4-4991-bc5b-7152c6e2a93a">
          <BaseURL>https://bcbolt446c5271-a.akamaihd.net/media/v1/dash/live/clear/57838016001/785d5ddf-6672-4ece-9191-d105445b2557/f5875617-40f4-4991-bc5b-7152c6e2a93a.vtt?akamai_token=exp=1484784452~acl=/media/v1/dash/live/clear/57838016001/785d5ddf-6672-4ece-9191-d105445b2557*~hmac=ae568ea5294280968de0a2766afd82922ea9aa83fe23a81b3379a46b8ef13284</BaseURL>
          </Representation>
        </AdaptationSet>
        
        

    文本跟踪資產的通知

    以下是特定於文本軌道提取的通知示例。

        {
          "entity": "en-captions-EN",
          "entityType": "ASSET",
          "version": "1",
          "action": "CREATE",
          "jobId": "ed429284-77c9-4905-a700-4c8edb77be3e",
          "videoId": "5209530177001",
          "accountId": "57838016001",
          "status": "SUCCESS"
        }
        {
          "entity": "es-captions-ES",
          "entityType": "ASSET",
          "version": "1",
          "action": "CREATE",
          "jobId": "ed429284-77c9-4905-a700-4c8edb77be3e",
          "videoId": "5209530177001",
          "accountId": "57838016001",
          "status": "SUCCESS"
        }
        
        

    樣本 player 帶有文本軌道(英語和西班牙語)

    動態投放視頻 Player

    iOS應用中的Sidecar字幕

    動態交付Sidecar字幕
    動態交付Sidecar字幕

    檢索動態演繹

    要檢索有關視頻的動態演示的信息,請將GET請求提交至:

        https://cms.api.brightcove.com/v1/accounts/account_id/videos/video_id/assets/dynamic_renditions
        
        

    樣品回复

        [
          {
            "rendition_id": "default/audio128",
            "frame_height": null,
            "frame_width": null,
            "media_type": "audio",
            "size": 506818,
            "created_at": "2016-11-14T15:05:56.209214859Z",
            "updated_at": "2016-11-14T15:05:56.209214859Z",
            "encoding_rate": 125,
            "duration": 31488,
            "audio_configuration": "L_R",
            "language": "en"
          },
          {
            "rendition_id": "default/audio64",
            "frame_height": null,
            "frame_width": null,
            "media_type": "audio",
            "size": 261129,
            "created_at": "2016-11-14T15:05:53.926747456Z",
            "updated_at": "2016-11-14T15:05:53.926747456Z",
            "encoding_rate": 62,
            "duration": 31488,
            "audio_configuration": "L_R",
            "language": "en"
          },
          {
            "rendition_id": "default/audio96",
            "frame_height": null,
            "frame_width": null,
            "media_type": "audio",
            "size": 384568,
            "created_at": "2016-11-14T15:05:59.023381448Z",
            "updated_at": "2016-11-14T15:05:59.023381448Z",
            "encoding_rate": 94,
            "duration": 31488,
            "audio_configuration": "L_R",
            "language": "en"
          },
          {
            "rendition_id": "default/video1200",
            "frame_height": 540,
            "frame_width": 960,
            "media_type": "video",
            "size": 4761241,
            "created_at": "2016-11-14T15:06:10.410020728Z",
            "updated_at": "2016-11-14T15:06:10.410020728Z",
            "encoding_rate": 1206,
            "duration": 31465
          },
          {
            "rendition_id": "default/video1700",
            "frame_height": 540,
            "frame_width": 960,
            "media_type": "video",
            "size": 6712422,
            "created_at": "2016-11-14T15:06:15.593063021Z",
            "updated_at": "2016-11-14T15:06:15.593063021Z",
            "encoding_rate": 1703,
            "duration": 31465
          },
          {
            "rendition_id": "default/video2500",
            "frame_height": 720,
            "frame_width": 1280,
            "media_type": "video",
            "size": 9795721,
            "created_at": "2016-11-14T15:06:12.148783841Z",
            "updated_at": "2016-11-14T15:06:12.148783841Z",
            "encoding_rate": 2486,
            "duration": 31465
          },
          {
            "rendition_id": "default/video4000",
            "frame_height": 1080,
            "frame_width": 1920,
            "media_type": "video",
            "size": 15718943,
            "created_at": "2016-11-14T15:06:15.463012005Z",
            "updated_at": "2016-11-14T15:06:15.463012005Z",
            "encoding_rate": 3992,
            "duration": 31465
          },
          {
            "rendition_id": "default/video450",
            "frame_height": 270,
            "frame_width": 480,
            "media_type": "video",
            "size": 1784858,
            "created_at": "2016-11-14T15:06:20.719400854Z",
            "updated_at": "2016-11-14T15:06:20.719400854Z",
            "encoding_rate": 451,
            "duration": 31465
          },
          {
            "rendition_id": "default/video700",
            "frame_height": 360,
            "frame_width": 640,
            "media_type": "video",
            "size": 2746520,
            "created_at": "2016-11-14T15:06:10.918331816Z",
            "updated_at": "2016-11-14T15:06:10.918331816Z",
            "encoding_rate": 695,
            "duration": 31465
          },
          {
            "rendition_id": "default/video900",
            "frame_height": 360,
            "frame_width": 640,
            "media_type": "video",
            "size": 3561912,
            "created_at": "2016-11-14T15:06:17.295871425Z",
            "updated_at": "2016-11-14T15:06:17.295871425Z",
            "encoding_rate": 902,
            "duration": 31465
          }
        ]
        

    檢索要播放的URL

    要檢索有關視頻的動態演示的信息,請將GET請求提交至:

        https://edge.api.brightcove.com/playback/v1/accounts/account_id/videos/video_id
        
        

    樣品回复

        {
          "description": null,
          "poster_sources": [
          {
            "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/jit/57838016001/853641cb-d66b-4f08-bb02-8489b5fba897/main/1280x720/24s816ms/match/image.jpg"
          }
          ],
          "tags": [
            "dd-static"
          ],
          "cue_points": [],
          "custom_fields": {},
          "account_id": "57838016001",
          "sources": [
            {
              "ext_x_version": "4",
              "type": "application/x-mpegURL",
              "src": "https://manifest.prod.boltdns.net/manifest/v1/hls/v4/clear/57838016001/853641cb-d66b-4f08-bb02-8489b5fba897/10s/master.m3u8?fastly_token=NTk1YmE0ZmZfOGU5Njg0NGU1OWQ3NjI3ZDhmY2FhZTVmNGE0YzI1MWM1NjMyNTZkNzMzZmExMzRkN2ZmYzU0YWU5NzUyZTM2YQ%3D%3D"
            },
            {
              "ext_x_version": "5",
              "type": "application/x-mpegURL",
              "src": "https://manifest.prod.boltdns.net/manifest/v1/hls/v5/clear/57838016001/853641cb-d66b-4f08-bb02-8489b5fba897/10s/master.m3u8?fastly_token=NTk1YmE0ZmZfOTBkOThhYmQ5MWM0MmQwYmQwYTM4MGEzMjAzZTgyNDVlMDYzYzNhMzQ1ZWQ3MTMyMzVmM2Q1YjM2N2VlMjM0Yg%3D%3D"
            },
            {
              "type": "application/dash+xml",
              "src": "https://manifest.prod.boltdns.net/manifest/v1/dash/live-baseurl/clear/57838016001/853641cb-d66b-4f08-bb02-8489b5fba897/2s/manifest.mpd?fastly_token=NTk1YmE0ZmZfYzQyOWJiOTEzMGJmNGIyMjM1NmMwMzZmNGZkZjlkYjEzMzNmNzFlYmQxODg0Y2YzZDk3ZTljNzVhODg1YzRjMQ%3D%3D",
              "profiles": "urn:mpeg:dash:profile:isoff-live:2011"
            },
            {
              "avg_bitrate": 2129000,
              "width": 1280,
              "src": "https://bcbolt446c5271-a.akamaihd.net/media/v1/pmp4/static/clear/57838016001/853641cb-d66b-4f08-bb02-8489b5fba897/high.mp4?akamai_token=exp=1499178239~acl=/media/v1/pmp4/static/clear/57838016001/853641cb-d66b-4f08-bb02-8489b5fba897/high.mp4*~hmac=5880698556297bbe2f2f43ac8904c659c61fb9510db1a9bb106037eaea393339",
              "size": 13242064,
              "height": 720,
              "duration": 49690,
              "container": "MP4",
              "codec": "H264"
            },
            {
              "avg_bitrate": 574000,
              "width": 480,
              "src": "https://bcbolt446c5271-a.akamaihd.net/media/v1/pmp4/static/clear/57838016001/853641cb-d66b-4f08-bb02-8489b5fba897/mid.mp4?akamai_token=exp=1499178239~acl=/media/v1/pmp4/static/clear/57838016001/853641cb-d66b-4f08-bb02-8489b5fba897/mid.mp4*~hmac=75e51439623a41b93d2a234c25683e76d43656f97a9dfb8efe61a5342d5ff2da",
              "size": 3586929,
              "height": 270,
              "duration": 49690,
              "container": "MP4",
              "codec": "H264"
            }
          ],
          "name": "Canada_Geese_Family",
          "reference_id": null,
          "long_description": null,
          "duration": 49633,
          "economics": "AD_SUPPORTED",
          "published_at": "2017-06-05T11:20:52.412Z",
          "text_tracks": [],
          "updated_at": "2017-06-05T12:06:55.121Z",
          "thumbnail": "https://cf-images.us-east-1.prod.boltdns.net/v1/jit/57838016001/853641cb-d66b-4f08-bb02-8489b5fba897/main/160x90/24s816ms/match/image.jpg",
          "poster": "https://cf-images.us-east-1.prod.boltdns.net/v1/jit/57838016001/853641cb-d66b-4f08-bb02-8489b5fba897/main/1280x720/24s816ms/match/image.jpg",
          "offline_enabled": false,
          "link": null,
          "id": "5459968909001",
          "ad_keys": null,
          "thumbnail_sources": [
            {
              "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/jit/57838016001/853641cb-d66b-4f08-bb02-8489b5fba897/main/160x90/24s816ms/match/image.jpg"
            }
          ],
          "created_at": "2017-06-05T11:20:52.412Z"
        }
        
        

    DRM

    支持DRM,但與普通視頻攝取不同。 你做 需要在攝取配置文件中指定包裝。 而是根據您帳戶的DRM設置自動打包。 聯繫Brightcove支持 為視頻的DRM打包設置默認值。

    有關詳細信息,請參閱 使用DRM提取內容.

    帶水印的副本

    帶水印的副本 支持。 如果您希望在部分或全部視頻中添加水印,請聯繫Brightcove支持。

    請注意,可以為靜態動態投放配置文件添加帶水印的副本,但是 上下文感知編碼(CAE)配置文件。

    攝取狀態

    通過訂閱回調和/或查詢Status API以獲取作業的狀態,可以接收有關Dynamic Delivery提取處理的信息。

    回呼

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

    有關接收和解釋通知的詳細信息,請參見 通知

    狀態API

    您還可以使用Status API獲取提取作業的當前狀態。 狀態消息僅適用於過去7天內提交的提取作業。

    端點

    視頻的所有狀態消息
        https://cms.api.brightcove.com/v1/accounts/:account_id/videos/:video_id/ingest_jobs
        
        
        https://cms.api.brightcove.com/v1/accounts/57838016001/videos/5128433746001/ingest_jobs
        
        
    特定作業的狀態消息
        https://cms.api.brightcove.com/v1/accounts/:account_id/videos/:video_id/ingest_jobs/:job_id
        
        

    響應

    以下是當前正在處理的作業的示例響應。

        {
        "id": "7a196557-56ba-4218-ada5-e107ed554555",
        "state": "processing",
        "account_id": "57838016001",
        "video_id": "5128433746001",
        "error_code": null,
        "error_message": null,
        "updated_at": "2016-09-16T16:51:46.313Z",
        "started_at": "2016-09-16T16:51:22.258Z"
        }
        
        

    這裡最重要的項目是:

    • state :工作狀態( processing | publishing | finished | failed -完成這項工作並且可以播放視頻後, state finished )
    • error_code error_message :對於一項成功的工作,這些將是 null ; 對於失敗的作業,您將收到錯誤代碼和說明性消息

    這是一個失敗的作業的狀態消息示例,用於比較:

        {
        "id": "bc9dfb58-d502-43d5-97e4-41f3dcd44265",
        "state": "failed",
        "account_id": "57838016001",
        "video_id": "5128710227001",
        "error_code": "NoMediaError",
        "error_message": "Audio-only output was requested on a file that only contains video.",
        "updated_at": "2016-09-16T20:30:58.016Z",
        "started_at": "2016-09-16T20:29:14.139Z"
        }
        
        

    上下文感知編碼

    上下文感知編碼(CAE)是Brightcove開發的一項技術,用於在轉碼過程中分析源視頻,並根據視頻的複雜性和所提供的一組邊界參數(最小再現次數,最大比特率)生成最佳的再現和比特率集。等)。

    要了解如何使用CAE配置文件,請參閱 上下文感知編碼.

    多個音軌

    可以啟用為動態投放設置的帳戶,以允許視頻的多個音軌。

    將多個音軌與單個標題關聯的功能在以下幾個關鍵場景中很有用:

    • 播放不同語言的同一視頻,以在全球範圍內擴大覆蓋範圍
    • 為視障者提供音頻和描述

    有關使用此功能的詳細信息,請參見 多個音軌.

    樣例代碼

    學習服務提供了幾個示例應用程序,這些應用程序提供了網絡界面並發送 Dynamic Ingest API 通過PHP代理的請求。 查看示例應用.

    此外,以下GitHub存儲庫包含Java,Python和C#的示例代碼-請注意,此示例代碼為 不支持 通過Brightcove:

    限制

    • 對於分段視頻類型(HLS和DASH),一些 players不能處理音頻和視頻流長度相差超過段持續時間的情況。 如果遇到這種情況,請嘗試使用較短的段長度。

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