WebVTTキャプション（テキストトラック）を追加する

このトピックでは、の使用方法を学習しますCMS APIキャプションまたはチャプターのWebVTTテキストトラックをビデオに追加します。

入門

POSTリクエストを使用して最初にビデオを作成するときは、WebVTTキャプション（テキストトラック）を追加できません。

Video Cloudで取り込まれるテキストトラックの場合、ビデオを取り込むための動的取り込み要求にトラックを含めることができます。を参照してください。 WebVTTファイルの取り込み詳細については。
テキストトラックが離れた場所でホストされる場合は、を使用してビデオに追加できます。PATCHビデオメタデータの更新をリクエストします。を参照してくださいCMS APIサンプル：ビデオを更新する更新リクエストの例については。

テキストトラックが取り込まれるかリモートであるかに関係なく、PATCHテキストトラックに関連付けられたメタデータの更新をリクエストする（scrlangまたはlabel、またはテキストトラックがdefaultビデオ用）。

こちらもご覧くださいCMS APIを使用したテキストトラックの管理テキストトラックがリモートであるか、静的な取り込みプロファイルで取り込まれるか、動的な取り込みプロファイルで取り込まれるかによる、テキストトラックメタデータの処理方法の違いの詳細については。

注

Dynamic Deliveryビデオのテキストトラックを更新すると、プロセスは非同期になるため、応答ステータスコードは次のようになります。202 ACCEPTED、および更新はすぐには行われません。
ビデオごとに1000テキストトラックの制限があります。
日本語や韓国語などの2バイト言語で正しく表示するには、キャプションのテキストをUTF-8でエンコードする必要があります。

リモートまたは摂取

認証

へのリクエストCMS APIアクセストークンを含む認証ヘッダーが必要です。クライアントクレデンシャルを取得してアクセストークンを取得する方法の詳細については、「 Brightcove OAuth の概要」を参照してください。

ビデオメタデータを更新するために必要な操作は次のとおりです。video-cloud/video/updateまたは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
    }
    ]}

テキストトラックの置き換え

既存のテキストトラック（アップロードまたはリモート）の置き換えは、2段階のプロセスです。

を介して既存のテキストトラックを削除しますCMS API更新（パッチ）：
API リクエスト (パッチ)
```
    https://cms.api.brightcove.com/v1/accounts/account_id/videos/video_id
```
リクエスト本文
```
    {
          "text_tracks": []
      }
```

リモートテキストトラックを追加する場合は、別のトラックを介して追加しますCMS API更新（パッチ）（オプション-テキストトラックをアップロードする場合は、次の手順にスキップします）：

API リクエスト (パッチ)

    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 IngestAPIに追加します。

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
```

ページコンテンツ

WebVTTキャプション（テキストトラック）を追加する

入門

注

リモートまたは摂取

認証

構文

要求

リクエスト本文:

テキストトラックの置き換え

API リクエスト (パッチ)

リクエスト本文

API リクエスト (パッチ)

リクエスト本文

APIリクエスト（POST）

リクエスト本文