サポート サポート問い合わせ先 | システムステータス システムステータス

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

このトピックでは、 CMS API キャプションやチャプターのWebVTTテキストトラックをビデオに追加することができます。

概要

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

  • テキストトラックをインジェストするには Video Cloud、その動画を取り込むためのダイナミックインジェストリクエストにトラックを含めることができます。 WebVTTファイルの取り込み 詳細については。
  • テキストトラックをあるリモートロケーションでホストする場合は、テキストトラックを PATCH ビデオメタデータの更新を要求します。 を参照してください CMS API サンプル:ビデオを更新する 更新要求の例については、

テキストトラックがインジェストされているのかリモートなのかに関係なく、 PATCH テキストトラックに関連するメタデータを更新するよう要求する(例えば、 scrlang or label、またはテキストトラックが default ビデオのために)。

ノート

  • ダイナミックデリバリービデオのテキストトラックを更新すると、プロセスは非同期になるため、レスポンスステータスコードは 202 ACCEPTED更新が直ちに行われることはありません。
  • ビデオごとに1000のテキストトラックの制限があります。
  • キャプションのテキストは、日本語や韓国語などの2バイト言語で正しく表示されるように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
    }
    ]}

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

既存のテキストトラック(アップロード済みまたはリモート)を置き換えることは、2つのステップからなるプロセスです。

  1. 既存のテキストトラックを削除する CMS API 更新(PATCH):

    APIリクエスト(PATCH)

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

    ボディをリクエストする

        {
              "text_tracks": []
          }
  2. リモートテキストトラックを追加する場合は、別のテキストトラックを追加します CMS API update(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"
                }
            ]
        }
  3. 代わりに新しいテキストトラックをアップロードする場合は、POSTリクエスト経由で Dynamic Ingest API:

    APIリクエスト(POST)

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

    ボディをリクエストする

        {
            "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

ページの最終更新日:12年2020月XNUMX日