添加WebVTT字幕（文本軌道）

在本主題中，您將學習如何使用 CMS API 將字幕或章節的WebVTT文本軌道添加到視頻中。

簡介

最初使用POST請求創建視頻時，無法添加WebVTT字幕（文本軌道）：

要吸收文本軌道 Video Cloud，曲目可以包含在“動態提取”請求中以提取視頻-請參閱提取WebVTT文件有關詳細信息。
如果文本軌道將託管在某個遠程位置，則可以使用以下命令將它們添加到視頻中： PATCH 請求更新視頻元數據。看到 CMS API 示例：更新視頻有關更新請求的示例。

不論是攝取文字音軌還是遠程音軌，都可以使用 PATCH 請求更新與文本軌道關聯的元數據（例如 scrlang or label，或者文本軌道是否為 default 視頻）。

筆記

當您更新Dynamic Delivery視頻上的文本軌道時，該過程是異步的，因此響應狀態代碼為 202 ACCEPTED，並且更新不會立即進行。
每個視頻最多只能有1000條文字軌道。
字幕的文本必須編碼為UTF-8，才能正確顯示雙字節語言（如日語和韓語）。

遠程或攝取

授權

要求 CMS API 需要包含您的訪問令牌的授權標頭。有關如何獲取客戶端憑據並使用它們來檢索訪問令牌的詳細信息，請參閱 Brightcove OAuth概述.

您需要更新視頻元數據的操作是 video-cloud/video/update or video-cloud/video/all.

句法

要求

              https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_ID}

要求正文：

請求主體將是一個JSON對象，其中包含文本軌道數組：

    {"text_tracks" : [ {
      "src" : "http://learning-services-media.brightcove.com/captions/bc_smart_ja.vtt",
      "srclang" : "ja",
      "label" : "日本人",
      "kind" : "captions",
      "mime_type" : null,
      "default" : false
    }, {
      "src" : "http://learning-services-media.brightcove.com/captions/bc_smart_es.vtt",
      "srclang" : "es",
      "label" : "español",
      "kind" : "captions",
      "mime_type" : null,
      "default" : false
    }, {
      "src" : "http://learning-services-media.brightcove.com/captions/bc_smart_de.vtt",
      "srclang" : "de",
      "label" : "Deutsch",
      "kind" : "captions",
      "mime_type" : null,
      "default" : false
    }, {
      "src" : "http://learning-services-media.brightcove.com/captions/bc_smart_fr.vtt",
      "srclang" : "fr",
      "label" : "français",
      "kind" : "captions",
      "mime_type" : null,
      "default" : false
    }, {
      "src" : "http://learning-services-media.brightcove.com/captions/bc_smart.vtt",
      "srclang" : "en",
      "label" : "English",
      "kind" : "captions",
      "mime_type" : null,
      "default" : true
    }
    ]}

取代文字軌道

替換現有文本軌道（上載或遠程）的過程分為兩個步驟：

通過刪除現有的文本軌道 CMS API 更新（PATCH）：

API請求（PATCH）

    https://cms.api.brightcove.com/v1/accounts/account_id/videos/video_id

請求正文

    {
          "text_tracks": []
      }

如果要添加遠程文本軌道，請通過另一個添加 CMS API 更新（PATCH）（可選-如果要上載文本軌道，請跳至下一步）：

API請求（PATCH）

    https://cms.api.brightcove.com/v1/accounts/account_id/videos/video_id

請求正文

    {
        "text_tracks": [
            {
              "src": "https://learning-services-media.brightcove.com/vtt/sample.vtt",
              "srclang": "en",
              "label": "EN",
              "kind": "captions",
              "mime_type": "text/webvtt"
            },
            {
              "src": "https://learning-services-media.brightcove.com/vtt/sample-es.vtt",
              "srclang": "es",
              "label": "ES",
              "kind": "captions",
              "mime_type": "text/webvtt"
            }
        ]
    }

如果您要上傳新的文本軌道，請通過POST請求將其添加到 Dynamic Ingest API:

API請求（POST）

    https://ingest.api.brightcove.com/v1/accounts/account_id/videos/video_id/ ingest請求

請求正文

    {
        "text_tracks": [
            {
                "url": "http://solutions.brightcove.com/bcls/assets/vtt/sample.vtt",
                "srclang": "en",
                "kind": "captions",
                "label": "EN",
                "default": true
            },
            {
                "url": "http://solutions.brightcove.com/bcls/assets/vtt/sample-ar.vtt",
                "srclang": "ar",
                "kind": "captions",
                "label": "AR",
                "default": false
            }
        ]
    }

向GET請求 CMS API 驗證您的新文本軌道是否與視頻相關聯：

              https://cms.api.brightcove.com/v1/accounts/account_id/videos/video_id