攝取帶有多語言音軌的視頻

源視頻中的語言音軌可以保留在您的視頻雲視頻再現中。僅通過 Dynamic Ingest API 支持攝取多語言音軌,

簡介

源視頻中的語言音軌可以保留在您的視頻雲視頻再現中。通過支持攝取多語言音軌動態攝取 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 攝取視頻有兩個步驟

  1. 使用 CMS API 在 Video Cloud 中創建視頻對象
  2. 使用 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