字幕ソース
video-subtitle-src
Imgix の AI 文字起こしエンジンを使用する代わりに、独自の VTT または SRT 字幕ファイルを外部トラックとして提供します。
video-subtitle-src は、公開アクセス可能な .vtt または .srt ファイルを指すパーセントエンコードされた URL を受け取ります。Imgix はリクエスト時にファイルを取得し、字幕トラックとして出力に組み込みます。
https://assets.imgix.net/videos/girl-reading-book-in-library.mp4?fm=hls&video-subtitle-src=https%3A%2F%2Fexample.com%2Fsubtitles.vtt&video-subtitle-lang=en複数のトラック
複数の字幕トラックを追加するには、インデックス付きバリアントを使用します：video-subtitle-src[1]、video-subtitle-src[2] などです。ベースの video-subtitle-src は video-subtitle-src[0] と同等です。各インデックス付きソースに対応する video-subtitle-lang[N] を組み合わせて、トラックの言語をタグ付けしてください。
https://assets.imgix.net/videos/girl-reading-book-in-library.mp4?fm=hls
&video-subtitle-src[0]=https%3A%2F%2Fexample.com%2Fen.vtt
&video-subtitle-lang[0]=en
&video-subtitle-src[1]=https%3A%2F%2Fexample.com%2Fes.vtt
&video-subtitle-lang[1]=es各インデックス付きトラックは HLS または DASH マニフェストの別の字幕レンディションとして、またはサイドカー VTT 配信の選択可能なトラックとして配信されます。
Base64 バリアント
字幕 URL にパーセントエンコードが困難な文字が含まれている場合は、video-subtitle-src64[N] を使用して URL を Base64 エンコード文字列として指定できます。値は標準の Base64 エンコード URL である必要があります。
https://assets.imgix.net/videos/girl-reading-book-in-library.mp4?fm=hls&video-subtitle-src64=aHR0cHM6Ly9leGFtcGxlLmNvbS9zdWJ0aXRsZXMudnR0&video-subtitle-lang=enエイリアス
video-caption-src および video-caption-src64 は、それぞれ video-subtitle-src および video-subtitle-src64 のエイリアスとして使用できます。
配信方法
提供された字幕トラックは AI 生成トラックと同じ方法で配信されます：
- HLS / DASH （
fm=hls、fm=dash）：トラックはマニフェストに字幕レンディションとして埋め込まれます。メディアプレーヤーが自動的に表示します。 - サイドカー VTT （
fm=vtt）：複数のトラックが存在する場合、video-subtitle-langを使用してどのトラックを返すかを選択できます。
video-subtitle-src が設定されている場合、Imgix は提供されたファイルをキャプションソースとして使用し、video-generate-subtitles=true が同時に指定されていても AI 文字起こしは実行されません。提供されたファイルが常に優先されます。
ライブデモ
以下のプレーヤーでは、インデックス付き video-subtitle-src[N] を使用して2つの字幕トラックを読み込んでいます — 英語トラックとフランス語訳で、両方とも静的 VTT ファイルとしてホストされています。プレーヤーコントロールの CC/字幕ボタンから言語を切り替えてください。
https://assets.imgix.net/Source%20Upload.mp4?fm=vtt
&video-subtitle-src[0]=https%3A%2F%2Fassets.imgix.net%2Fdocs%2Fsubtitles-byos-demo.vtt
&video-subtitle-lang[0]=en
&video-subtitle-src[1]=https%3A%2F%2Fassets.imgix.net%2Fdocs%2Fsubtitles-byos-demo-fr.vtt
&video-subtitle-lang[1]=fr