簡介
源視頻中的語言音軌可以保留在您的視頻雲視頻再現中。通過支持攝取多語言音軌動態攝取 API僅有的 ,
有關如何使用 API 攝取視頻的一般信息,請參閱 動態攝取 API 概述。
注意事項和限制
- 您必須僅輸入 ISO 639-2 三字母代碼,僅使用術語而不是 書目 代碼。
- 當沒有提供的語言代碼與源音頻匹配時,我們將處理默認語言並使用提供的語言代碼對其進行標記
- 如果您確實指定了參考書目語言代碼並且它與源軌道匹配,我們會將語言代碼附加到該軌道,但您應該 始終 使用 術語 語言代碼。
- 當指定多個軌道時,
default
我們將使用源中找到的第一個曲目(如果有的話)或第一個攝入作為默認音軌 - 如果您將非英文曲目指定為默認音軌,但沒
language
有提供該曲目,我們將其標記為「eng」。 - 處理隊列中最多只能有 100 個作業(除非您指定 低優先級 處理)。如果您要添加大量音軌,您可能會達到此限制,並且請求將失敗,直到處理隊列低於 100。有關詳細信息,請參閱 回退/重試策略 。
-
並非所有音頻服務類型都受支持:只能使用以下類型:
main
alternate
commentary
dub
descriptive
- 當你添加 eng > 主要和工程 > 攝取期間的評論軌道和源包含沒有音頻服務類型的 eng,源音頻將在輸出再現中丟失。
- 如果您包含兩個具有相同語言代碼的音軌,並將其中一個音軌指定為
variant
並且不提供另一個服務類型,則擷取將會失敗。 - 當具有單個音軌的視頻被具有多語言音軌的視頻替換時,原始單一語言的軌道也將包含在演繹中,並帶有其原始語言標識符。
- 源視頻中的多個音軌和其他單獨的音頻文件均可用於多個音軌。Video Cloud 不存儲音頻母版,但是 - 用作備用音軌的單獨音頻文件必須託管在公共 URL 上。
- 默認情況下,外部音軌將與視頻中包含的音軌合併。如果您想替換視頻中包含的音軌,則可以將標
merge_with_existing
誌設置為false
。 - 對於不屬於媒體信息的任何主音軌,攝取 不會 使作業失敗,並且該音軌將被跳過。
- 對於主音軌輸入,任何一種語言或變體都可以在
master.audio_tracks
對像中傳遞。在這種情況下,我們將在媒體信息中尋找它,如果不存在則跳過它。 - 如果曲目的語言或變體未在請求中指定,我們將默認
eng
為語言和main
變體。
使用動態攝取 API
使用 Dynamic Ingest API 攝取視頻有兩個步驟
創建視頻對象
若要在 Video Cloud 視訊資料庫中建立新的視訊物件,請向以下地址POST
提出要求:
https://cms.api.brightcove.com/v1/accounts/ {account_id} /videos
您必須包含至少包含視訊的要求內文name
:
{
“名字” :“我的視頻標題”
}
您還可以包含其他視頻元數據(請參閱 CMS API 參考),但也可以稍後在 Studio 中或通過 CMS API 添加這些元數據。
響應將是一個包含許多視頻屬性的 JSON 對象。第一個將是視頻id
,您將需要此值才能提出導入請求。
內嵌視訊
建立視訊物件並擷取其後id
,您可以將POST
要求傳送至 Video Cloud,將視訊內嵌至 Video Cloud:
https://ingest.api.brightcove.com/v1/accounts/ {account_id} /videos/ {video_id} /ingest-requests
要求主體
首先讓我們看一個包含三個音軌的視頻的簡單示例。請求正文看起來像這樣:
{
"master": {
"url": "{source_url}",
"audio_tracks": [
{
"language": "eng",
"variant": "main"
},
{
"language": "spa",
"variant": "main"
}
]
},
"profile": "multi-platform-extended-static-with-mp4"
}
現在讓我們看一個更複雜的示例,其中視頻包含多個音軌,我們正在添加一些位於單獨文件中的額外音軌:
{
“掌握”: {
“網址”:“ {source_url} ”,
“audio_tracks”:[
{
“語言”:“英文”,
“變體”:“主要”
},
{
“語言”:“fra”,
“變體”:“主要”
},
{
“語言”:“水療中心”,
“變體”:“主要”
}
]
},
“輪廓”:“使用 MP4 擴展的多平台”,
“audio_tracks”:
{
“merge_with_existing”:是的,
“大師”:[
{
“網址”:“https://some.site.com/audio/alternate-en.m4a”,
“語言”:“英文”,
“變體”:“替代”
},
{
“網址”:“https://some.site.com/audio/commentary-es.m4a”,
“語言”:“水療中心”,
“變體”:“評論”
}
}
]
}
在這個例子中:
master
>url
是來源視訊檔案的位置master
> 提audio_tracks
供有關嵌入在視頻中的音軌信息- 請注意,語言代碼應來自 https://www.iana.org/assignments/language-subtag-registry/language-subtag-registry
- 這
profile
是要使用的擷取設定檔的名稱-如果省略此選項,將使用帳戶的預設設定檔 - 額外的
audio_tracks
陣列包含有關單獨的外部託管音訊檔案的資訊,以用作其他音訊軌道 merge_with_existing
意味著「除了嵌入式音軌之外使用遠程音軌」,如果true
(或者如果用遙控器替換嵌入式音軌false
)-
的
variant
字段描述了音軌的種類。具有標準含義的可能值為:main
-主音軌,通常是混音到視頻文件中的那一條alternate
-備用音軌commentary
-提供有關視頻軌道的評論的音頻軌道dub
-包含另一種語言的配音版本的曲目descriptive
-軌道以某種方式描述了視頻內容
補充筆記:
- 攝取請求還有其他(所有可選)字段,例如添加圖像和文本軌道。有關完整詳細信息,請參閱 動態攝取 API 參考 。
- 您不必一次攝取所有視頻資產。例如,在上面的示例中,您可以先攝取帶有嵌入式音軌的視頻,然後提交單獨的請求以添加額外的遠程音軌。
Brightcove 播放器中的多個音軌
當您在 Brightcove 播放器中嵌入帶有多個音軌的視頻時,可以從播放器控制欄中的選擇器中使用這些音軌:
設置默認音軌
您無法在攝取期間設置默認音軌(處理中遇到的第一個音軌將設置為默認音軌)。但是,您可以在 Studio 中或使用 CMS API 更改默認軌道。
在工作室
有關在 Studio 中設置默認音軌的說明,請參閱 設置默認音軌。
使用CMS API
有關使用 CMS API 設置默認音軌的說明,請參閱 更新音軌。
音頻服務類型
杜比音頻編解碼器(ac-3 和 eac-3)支持包括音頻服務類型元數據。(AAC 音頻 不能 包含服務類型元數據。)
可以為支持的杜比音軌指定以下服務類型:
main
music_and_effects
visually_impaired
hearing_impaired
dialogue
commentary
emergency
voice_over