概述： 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 包含簽名, 過期和 AWSAccessKeyId和 v4 包含 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請求：

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

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

CMS API 請求

HTTP方法

POST

要求網址

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

請求正文

    {
    "name": "My First Dynamic Delivery Video"
    }

欲了解更多有關信息 CMS API 呼叫以在 Video Cloud 系統，請參閱 CMS API 概述。請注意，視頻 name 是必需的，並且名稱和視頻元數據中包含的任何其他字符串（例如 description ) 必須使用URI編碼.

響應數據將包括視頻 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字幕

檢索動態演繹

要檢索有關視頻的動態演示的信息，請將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

例

https://cms.api.brightcove.com/v1/accounts/57838016001/videos/5128433746001/ingest_jobs/7a196557-56ba-4218-ada5-e107ed554555

響應

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

    {
    "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不能處理音頻和視頻流長度相差超過段持續時間的情況。如果遇到這種情況，請嘗試使用較短的段長度。

頁面內容

概述： Dynamic Ingest API

簡介

工作流程概述

操作

最佳實踐

有效的來源位置

基於拉取的攝取

關於S3的注意事項

FTP注意事項

源文件上傳

特殊字符

源文件名

樣本資產

攝取個人資料

樣本動態投放資料

攝取視頻

CMS API 請求

提取API請求

筆記

查看渲染

替換視頻

重新轉換視頻

圖像攝取

樣品申請機構

圖像資產提取通知

字幕攝取

樣品申請機構

HLS

短跑

文本跟踪資產的通知

樣本 player 帶有文本軌道（英語和西班牙語）

iOS應用中的Sidecar字幕

檢索動態演繹

樣品回复

檢索要播放的URL

樣品回复

DRM

帶水印的副本

攝取狀態

回呼

狀態API

端點

視頻的所有狀態消息

例

特定作業的狀態消息

例

響應

上下文感知編碼

多個音軌

樣例代碼

限制