內嵌欄位參考

本主題提供對Dynamic Ingest API的請求正文字段的參考。另請參閱API參考。

動態內嵌欄位

視訊雲端內嵌欄位
欄位 類型 描述
master選擇性 物件

要攝入的視頻主人
master.url選擇性 網址

視訊來源的 URL；除了已封存數位主版的重新轉碼外，或者您正在將影像或文字軌跡新增至現有的視訊除外
master.use_archived_master選擇性 布林值

對於重新轉碼請求，如果設置為，將使用存檔的主文件true ;如果設置為false，還必須包括url用於源視頻
master.audio_tracks選擇性 物件

一個audio_tracks內的對象master對象包含視頻文件中包含的音軌的元數據（如果有的話，也稱為“混入音頻）-由於音頻軌道已包含在視頻文件中，因此僅包含元數據，而沒有音頻文件的URL-請參見使用API實施多個音軌欲獲得更多信息
master.audio_tracks.language選擇性 字串

來自 https://www.iana.org/assignments/language-subtag-registry/language-subtag-registry 中子標籤的混合音頻的語言代碼（可以通過聯繫 Brightcove 支持為帳戶設置默認值） 僅動態交付
master.audio_tracks.variant選擇性 字串

混音的音軌類型（可以通過聯繫Brightcove支持為帳戶設置默認值）-對於混音的音軌，通常是main僅動態投放

允許的值："main""alternate"、、"commentary"、"dub"、"descriptive"
audio_tracks僅限選擇性動態傳送 物件 []

音軌對像數組-請參閱使用API實施多個音軌欲獲得更多信息。
audio_tracks.merge_with_existing選擇性 布林值

是否替換現有的音軌或添加新的音軌僅動態投放

默認值：true
audio_tracks.masters選擇性 物件 []

音訊軌物件陣列僅動態傳遞
audio_tracks.masters.url選擇性 字串

音頻文件的URL 僅動態投放
audio_tracks.masters.language選擇性 字串

來自中的子標籤的音軌的語言代碼https://www.iana.org/assignments/language-subtag-registry/language-subtag-registry（可以通過聯繫Brightcove支持為帳戶設置默認值）僅動態投放
audio_tracks.masters.variant選擇性 字串

音軌的類型（可以通過聯繫Brightcove支持為帳戶設置默認值）僅動態投放

允許的值："main""alternate"、、"commentary"、"dub"、"descriptive"
forensic_watermarking選擇性 布林值 是否應將鑑識浮水印新增至視訊轉譯-如果您將其設定為true帳戶，則必須啟用鑑識浮水印，否則該欄位將會被忽略-請參閱概述：法醫浮水印了解更多詳情
forensic_watermarking_stub_mode選擇性 布林值 W 是否應將可見的鑑識浮水印新增至視訊轉譯-如果將其設定為 true，則必須啟用帳戶以進行鑑識浮水印，並且該forensic_watermarking欄位也必須設定為 true-請參閱概述：鑑證水印了解更多詳細信息可見水印應僅用於測試集成，以確保法醫水印已成功添加到視頻中（使用至少 10 分鐘長的視頻）。驗證完成後，必須透過提交新的擷取要求來重新轉碼影片來移除它們- forensic_watermarking_stub_mode必須在重新轉碼要求上將其設定為 false。
profile選擇性 字串

提取用於轉碼的配置文件；如果不存在，將使用默認配置文件
transcriptions選擇性 物件 []

自動字幕的轉錄對像數組
transcriptions.autodetect選擇性 布林值 true自動檢測來自音頻源的語言。false使用srclang指定音訊語言。
transcriptions.default選擇性 布林值 如果true，srclang將被忽略，並且將使用主音軌-語言將被自動檢測。
transcriptions.input_audio_track選擇性 物件 對於多個音軌，定義要從中提取字幕的音頻。它由語言和變體組成（兩者都是必需的）。
transcriptions.input_audio_track.language需要，如果input_audio_track包括 字串 文本軌道的 BCP-47 樣式語言代碼（en-US、fr-FR、es-ES 等）；查看 支持的語言
transcriptions.input_audio_track.variant需要，如果input_audio_track包括 字串 指定要使用的變體：
  • main
  • alternate
  • dub
  • commentary
  • descriptive
transcriptions.kind選擇性 字串 要生成的輸出類型。允許值：
  • 字幕
  • 成績單
注意事項：
  1. 如果 kind 是 transcripts ， 並且 包含 transcripts 文件的 url ，則將攝取 transcript 文件，並且不會生成自動字幕。有關更多詳細信息，請參閱 攝取轉錄 。
  2. 如果種類是成績單 , 和這網址對於成績單文件是不是包括在內，將生成成績單文件和字幕，
  3. 如果 kind 是 captions ，將生成一個 captions，而不是一個 transcript 文件。
transcriptions.label必要 字串 人類可讀的標籤。
transcriptions.srclang選擇性 字串 文本軌道的 BCP-47 樣式語言代碼（en-US、fr-FR、es-ES 等）；查看 支持的語言
transcriptions.status選擇性 字串 文本軌道的狀態，要么published或者draft（已添加但用戶不可用）；使用draft如果轉錄需要在發布前進行審查，並將其更新為published使用內容管理系統接口
transcriptions.url選擇性 字串 腳本文件所在的 URL。必須包含的 種類 是 成績單。必須不是被包括在內，如果種類是字幕 .
text_tracks選擇性 物件 []

的數組text_tracks對象-請參閱攝取WebVTT文件（文本軌道）
text_tracks.url 網址

WebVTT文件的URL
text_tracks.srclang 字串

文本軌道的ISO 639 2字母（alpha-2）語言代碼
text_tracks.kind選擇性 字串

如何使用vtt文件

默認值：captions

允許的值："captions""subtitles"、、"chapters"、"metadata"、"transcriptions"
text_tracks.label選擇性 字串

用戶可讀的標題
text_tracks.default選擇性 布林值

設置字幕/字幕的默認語言
text_tracks.status選擇性 字串

將文字軌跡的狀態設定為publisheddraft、或null (預設值)。如果設定為draft，文字軌道將不會顯示在播放器中。
images 大批 {} 描述要攝取的圖像的對像數組 - 有關更多信息，請參閱 圖像和動態攝取
variant 字串 圖像類型 - 以下之一：
  • poster
  • thumbnail
  • portrait
  • square
  • wide
  • ultra-wide
language 字串 多語言變體的語言代碼 - 來自 https://www.iana.org/assignments/language-subtag-registry/language-subtag-registry的代碼
height 編號 以像素為單位的高度
Width 編號 以像素為單位的寬度
url 串 發布圖片的網址
capture-images選擇性 布林值

在轉碼過程中是否應捕獲海報和縮略圖；默認為true如果個人資料具有圖像副本，false如果沒有，請參閱圖片和Dynamic Ingest API欲獲得更多信息
poster選擇性 物件

要攝取的視頻海報-請參閱圖片和Dynamic Ingest API欲獲得更多信息
poster.url 網址

視頻海報圖像的URL
poster.height選擇性 整數

圖像的像素高度
poster.width選擇性 整數

圖像的像素寬度
thumbnail選擇性 物件

要提取的視頻縮略圖-請參見圖片和Dynamic Ingest API欲獲得更多信息
thumbnail.url 網址

視頻縮略圖的網址
thumbnail.height選擇性 整數

圖像的像素高度
thumbnail.width選擇性 整數

圖像的像素寬度
callbacks選擇性 串[] URL數組通知應該發送到