攝取成績單文件

動態收錄可用於隨視頻一起收錄轉錄文件,或在收錄視頻後單獨收錄。

設定

動態攝取請求的設置是相同的,無論您是攝取視頻、圖像、腳本文件還是所有這些。有關請求正文字段的完整詳細信息,請參閱 API 參考

請求網址
        https://ingest.api.brightcove.com/v1/accounts/account_id/videos/video_id/ingest-requests
驗證
身份驗證需要一個訪問令牌作為Bearer令牌在Authorization標頭:
        Authorization: Bearer {access_token}

關於 S3 的注意事項

如果您的成績單將從受保護的 S3 存儲桶中提取,您將需要設置存儲桶策略以允許 Video Cloud 訪問這些文件。如需詳細資訊,請參閱使用 S3 的動態內嵌

攝取成績單文件

您還可以將腳本文件添加到您的視頻或使用動態攝取將它們上傳到現有視頻:

在視頻攝取期間添加成績單

請求網址

https://ingest.api.brightcove.com/v1/accounts/account_id/videos/video_id/ingest-requests

方法

POST

請求主體範例

{
  "master": {
    "url": "https://support.brightcove.com/test-assets/videos/Great_Blue_Heron.mp4"
  },
  "transcriptions": [
    {
      "url": "https://support.brightcove.com/test-assets/transcript/herons-transcript.txt",
      "srclang": "en-US",
      "kind": "transcripts",
      "label": "English",
      "default": true,
      "status" : "published"
    }
  ]
}

添加成績單現有視頻

向現有視頻添加轉錄本完全相同,只是您不需要請求正文中的任何視頻信息或個人資料。 除非您要求將封閉式成績單添加到 MP4 演繹版中 - 在這種情況下,您將需要替換視頻

請求網址

        https://ingest.api.brightcove.com/v1/accounts/account_id/videos/video_id/ingest-requests

方法

POST

請求主體範例

{
  "transcriptions": [
    {
      "url": "https://support.brightcove.com/test-assets/transcripts/herons.txt",
      "srclang": "en-US",
      "kind": "transcripts",
      "label": "English",
      "default": true,
      "status" : "published"
    }
  ]
}

攝取字段

下表詳細說明了用於獲取文字記錄或 請求自動字幕的字段。

自動字幕和文字記錄字段
欄位 類型 必填 描述
autodetect 布林 true自動檢測來自音頻源的語言。false使用srclang指定音訊語言。
default 布林 如果truesrclang將被忽略,並且將使用主音軌-語言將被自動檢測。
input_audio_track 對象 對於多個音軌,定義要從中提取字幕的音頻。它由語言和變體組成(兩者都是必需的)。
kind 要生成的輸出類型。允許值:
  • 字幕
  • 成績單
注意事項:
  1. 如果 kindtranscripts並且 包含 transcripts 文件的 url ,則將攝取 transcript 文件,並且不會生成自動字幕。有關更多詳細信息,請參閱 攝取轉錄
  2. 如果種類成績單 , 網址對於成績單文件是不是包括在內,將生成成績單文件和字幕,
  3. 如果 kindcaptions ,將生成一個 captions,而不是一個 transcript 文件。
label 人類可讀的標籤。默認為 BCP-47 風格的語言代碼。
srclang 文本軌道的 BCP-47 樣式語言代碼(en-US、fr-FR、es-ES 等);查看 支持的語言
status 指示註解的實際情況 (如果是published ) draft
url 腳本文件所在的 URL。必須包含的 種類成績單。必須不是被包括在內,如果種類字幕 .