擷取網頁 VTT 檔案

「動態內嵌」可用來將 WebVTT 檔案 (用於字幕、字幕、章節等),或是在影片攝入後分別內嵌視訊。對於 Dynamic Delivery 視頻,您還可以提取 SRT、DFXP 或 SCC 字幕。本主題說明如何使用動態內嵌 API 將文字軌檔案新增至視訊的詳細資料。

將隱藏式字幕添加到 MP4 再現

除了將文本軌道添加到 HLS 和/或 DASH 再現之外,您還可以添加608 隱藏式字幕通過包括"embed_closed_caption": true在您的 WebVTT 攝取請求中標記。

要為您正在收錄的視頻嵌入隱藏式字幕,請務必使用包含一個或多個 MP4 再現的收錄配置文件。如果您要向現有視頻添加文本軌道/隱藏式字幕,請確保它至少有一個 MP4 格式,或者使用包含 MP4 的攝取配置文件重新轉碼。

如果您使用的是 Cloud Playout,請注意您現在可以將 這些隱藏式字幕 導入您的頻道以提供給您的觀眾。

注意事項

  • 608 內嵌字幕目前支持的語言有:英語、西班牙語、法語、葡萄牙語、意大利語、德語和荷蘭語。
  • 對於嵌入式 608 字幕,僅支持歐洲(拉丁)字符。不支持中文、日文等雙字節語言。
  • 如果源文件已經包含 608 個隱藏式字幕,這些將不是保留在任何 MP4 再現中。相反,將使用提取的字幕的內容嵌入新的隱藏式字幕 .
  • 當前 無法 在您重新轉碼視頻時添加隱藏式字幕 - 您必須正在攝取或替換視頻。重新轉碼作業將在未來版本中支持此功能。
  • 此功能不能當你被使用請求自動字幕 .
  • 如果您的帳戶啟用了 Cloud Playout,您可以通過將視頻添加到頻道中來驗證是否添加了隱藏式字幕(Cloud Playout 頻道始終使用 MP4 格式)。

設定

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

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

關於 S3 的注意事項

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

攝取WebVTT文件

您還可以將WebVTT字幕添加到您的視頻中,或使用Dynamic Ingest將它們上傳到現有視頻中:

在視頻攝取期間添加文本軌道

請求網址

        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"
  },
  "text_tracks": [
      {
          "url": "https://support.brightcove.com/test-assets/captions/herons.vtt",
          "srclang": "en",
          "kind": "captions",
          "label": "EN",
          "default": true,
          "status" : "published",
          "embed_closed_caption": true
      }
  ]
}

添加/轉換SRT或DFXP

對於僅動態投放視頻,您可以採用相同的方式提取SRT或DFXP文件。Video Cloud提取系統將自動將它們轉換為WebVTT格式並將其添加到視頻中。

{
  "text_tracks": [
    {
      "url": "https://media.brightcove.com/captions/Water.dfxp",
      "srclang": "fr",
      "kind": "captions",
      "label": "français",
      "default": true,
      "status" : "published",
      "embed_closed_caption": true
    }
  ]
}

添加文字跟踪現有視頻

將文本軌道添加到現有視頻完全相同,只是您不需要請求正文中的任何視頻信息或配置文件。 除非您要求將隱藏式字幕添加到 MP4 再現中 - 在這種情況下,您將需要替換視頻

請求網址

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

方法

POST

示例請求正文 - 不請求隱藏字幕

{
  "text_tracks": [
    {
      "url": "https://some.site.com/captions/for_video/Water-in-Motion.vtt",
      "srclang": "es",
      "kind": "captions",
      "label": "Español",
      "default": true,
      "status" : "published",
      "embed_closed_caption": false
    }
  ]
}

樣本請求正文 - 請求隱藏式字幕

{
  "master": {
      "url": "https://support.brightcove.com/test-assets/videos/Great_Blue_Heron.mp4"
  },
  "text_tracks": [
      {
          "url": "https://support.brightcove.com/test-assets/captions/herons.vtt",
          "srclang": "en",
          "kind": "captions",
          "label": "EN",
          "default": true,
          "status" : "published",
          "embed_closed_caption": true
      }
  ]
}

將文本軌道添加到遠程資產視頻

看到將文本軌道添加到遠程資產視頻