セットアップ
動的取り込み要求の設定は、ビデオ、画像、WebVTT ファイル、またはこれらすべてを取り込むかどうかに関係なく同じです。
- URL をリクエスト
-
https://ingest.api.brightcove.com/v1/accounts/account_id/videos/video_id/ingest-requests - 認証
- 認証には、
BearerAuthorizationアクセストークンをトークンとしてヘッダーに渡す必要があります。Authorization: Bearer {access_token}
S3 に関する注意
WebVTTが保護されたS3バケットからプルされる場合は、VideoCloudがファイルにアクセスできるようにバケットポリシーを設定する必要があります。詳細については、「 S3 での動的取り込みの使用」を参照してください。
WebVTTファイルを取り込む
ダイナミックインジェストを使用して、WebVTTキャプションをビデオに追加したり、既存のビデオにアップロードしたりすることもできます。
ビデオの取り込み中にテキストトラックを追加する
URL をリクエスト
https://ingest.api.brightcove.com/v1/accounts/account_id/videos/video_id/ingest-requests
方法
POST
リクエスト本文の例
{
"master": {
"url":"http://learning-services-media.brightcove.com/videos/mp4/Water-Droplet.mp4"
},
"capture-images": false,
"text_tracks": [
{
"url": "http://learning-services-media.brightcove.com/captions/for_video/Water-in-Motion.vtt",
"srclang": "en",
"kind": "captions",
"label": "English",
"default": true
}
]
}
SRTまたはDFXPの追加/変換
にとって動的配信ビデオのみ、SRTまたはDFXPファイルを同じ方法で取り込むことができます。Video Cloud取り込みシステムは、それらを自動的にWebVTT形式に変換し、ビデオに追加します。
{
"text_tracks": [
{
"url": "http://media.brightcove.com/captions/Water.dfxp",
"srclang": "fr",
"kind": "captions",
"label": "français",
"default": true
}
]
}
テキストトラックを追加する既存のビデオ
既存の動画にテキストトラックを追加することはまったく同じですが、リクエスト本文に動画情報やプロファイルが必要ない点が異なります。
URL をリクエスト
https://ingest.api.brightcove.com/v1/accounts/account_id/videos/video_id/ingest-requests
方法
POST
リクエスト本文の例
{
"text_tracks": [
{
"url": "http://learning-services-media.brightcove.com/captions/for_video/Water-in-Motion.vtt",
"srclang": "es",
"kind": "captions",
"label": "Español",
"default": true
}
]
}