簡介
Brightcove的 Dynamic Ingest API 它基於以下功能:從客戶的存儲位置下載視頻源文件,並創建源文件的指定格式。 (也可以選擇 上傳您的源文件 該平台是以雲為中心的,全球分佈的,並且基於現代實踐來確定liver一流的一致性和速度。
另見 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 管理工具 或查看以下文件之一:
最佳實踐
有效的來源位置
基於拉取的攝取
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字幕:
攝取個人資料
創建動態De需要特殊的攝取配置文件livery視頻。 您會發現幾個 標準攝取檔案 在動態帳戶中live啟用ry,建議使用這些功能。
您還可以添加自定義動態Delivery配置文件到Studio的“管理”部分中的攝取配置文件-請參閱 為動態De創建提取配置文件livery 有關詳細信息。
動態樣本livery個人資料
以下是動態De的示例live您可以用來入門的ry個人資料。 您需要做的就是更換 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
}
]
}
}
有關標準動態設計的詳細信息livery個人資料和演繹,請參閱 動態De的標準攝取配置文件livery
攝取視頻
攝取視頻需要兩個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" }
響應數據將包括視頻 id
,在下一個請求中使用。
提取API請求
- HTTP方法
- POST
- 要求網址
- https://ingest.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/ingest-requests
- 請求正文
-
{ "master": { "url": "https://host/master.mp4" }, "profile": "DynamicDeliverIngestProfile", "callbacks": [ "https://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": "https://bcls@solutions.brightcove.com/bcls/assets/images/great-blue-heron-poster.png",
"width": 1280,
"height": 720
},
"thumbnail": {
"url": "https://bcls@solutions.brightcove.com/bcls/assets/images/great-blue-heron-thumbnail.png",
"width": 160,
"height": 90
},
"callbacks": [
"https://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": "https://solutions.brightcove.com/bcls/assets/vtt/sample.vtt",
"srclang": "en",
"kind": "captions",
"label": "EN",
"default": true
},
{
"url": "https://solutions.brightcove.com/bcls/assets/vtt/sample-es.vtt",
"srclang": "es",
"kind": "captions",
"label": "ES",
"default": false
}
],
"callbacks": [
"https://solutions.brightcove.com/bcls/di-api/di-callbacks.php"
]
}
與非動態Dee一樣,Sidecar文本軌道將顯示在CMS或播放響應中livery視頻:
"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 帶有文本軌道(英語和西班牙語)
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支持。
請注意,可以為靜態動態De添加帶水印的再現livery個人資料,但是 不 上下文感知編碼(CAE)配置文件。
攝取狀態
您可以在動態廣告上收到信息live通過訂閱回調和/或查詢Status API來獲取作業的狀態,從而進行收錄處理。
回呼
在提取請求中,您可以指定一個或多個回調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配置文件,請參閱 上下文感知編碼.
多個音軌
為動態De設置的帳戶live可以啟用ry來允許視頻有多個音軌。
將多個音軌與單個標題關聯的功能在以下幾個關鍵場景中很有用:
- 播放不同語言的同一視頻,以在全球範圍內擴大覆蓋範圍
- 為視障者提供音頻和描述
有關使用此功能的詳細信息,請參見 多個音軌.
樣例代碼
學習服務提供了幾個示例應用程序,這些應用程序提供了網絡界面並發送 Dynamic Ingest API 通過PHP代理的請求。 查看示例應用.
此外,以下GitHub存儲庫包含Java,Python和C#的示例代碼-請注意,此示例代碼為 不支持 通過Brightcove:
限制
- 對於分段視頻類型(HLS和DASH),一些 players不能處理音頻和視頻流長度相差超過段持續時間的情況。 如果遇到這種情況,請嘗試使用較短的段長度。