支持 聯繫支持 | 系統狀況 系統狀態

概述: 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日