サポート サポートへのお問い合わせ | システムステータス システムステータス
ページコンテンツ

    WebVTT キャプションの追加 (テキストトラック)

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

    はじめに

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

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

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

    • 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段階のプロセスです。

    1. を介して既存のテキストトラックを削除しますCMS API更新(パッチ):

      API リクエスト (パッチ)

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

      リクエスト本文

          {
                "text_tracks": []
            }
    2. リモートテキストトラックを追加する場合は、別のトラックを介して追加します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"
                  }
              ]
          }
    3. 代わりに新しいテキストトラックをアップロードする場合は、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
                  }
              ]
          }
    4. にGETリクエストを送信しますCMS API新しいテキストトラックがビデオに関連付けられていることを確認するには、次の手順に従います。
                    https://cms.api.brightcove.com/v1/accounts/account_id/videos/video_id