內嵌欄位參考

本主題提供對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選擇性 布林值 如果truesrclang將被忽略,並且將使用主音軌-語言將被自動檢測。
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. 如果 kindtranscripts並且 包含 transcripts 文件的 url ,則將攝取 transcript 文件,並且不會生成自動字幕。有關更多詳細信息,請參閱 攝取轉錄
  2. 如果種類成績單 , 網址對於成績單文件是不是包括在內,將生成成績單文件和字幕,
  3. 如果 kindcaptions ,將生成一個 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數組通知應該發送到