字幕翻訳
video-subtitle-translations
ショートフォーム動画の開始
ショートフォーム動画のパラメータを有効にするには fm=mp4 を設定する必要があります。
処理時間について
字幕の生成と翻訳は初回リクエスト時に処理され、数分かかる場合があります。処理中は VTT URL へのリクエストが 423 ステータスを返し、字幕を表示できません。処理完了後は、ソースの Video Cache TTL に従ってキャッシュされます。
エンドユーザーへの遅延を防ぐには、アップロードや公開ワークフローの一部として各言語の VTT URL をリクエストし、字幕と翻訳を事前生成しておくことをお勧めします。これによりキャッシュがウォームアップされ、プレーヤーが公開される前にすべての言語トラックが準備完了の状態になります。
video-subtitle-translations パラメータは、AI生成の字幕を1つ以上の言語に翻訳します。ISO 639-1 または ISO 639-2 の言語コードをカンマ区切りで指定します。このパラメータを使用するには video-generate-subtitles=true の設定が必要です。
翻訳先の言語が検出されたソース言語と一致する場合、その翻訳は自動的にスキップされます。
HLS および DASH 配信
fm=hls または fm=dash を使用する場合、指定した各言語の字幕トラックがマニフェストに直接埋め込まれます。hls.js やネイティブ Safari の HLS などのアダプティブプレーヤーは、個別の <track> 要素なしでこれらを字幕オプションとして自動的に表示します。
https://assets.imgix.net/videos/girl-reading-book-in-library.mp4?fm=hls&video-generate-subtitles=true&video-subtitle-translations=fr,deサイドカー VTT ファイル
ネイティブの <video> 要素では、fm=vtt と video-vtt-lang パラメータを使用して翻訳済みの VTT ファイルをリクエストします。言語ごとに個別の VTT URL を指定した <track> 要素が必要です。
https://assets.imgix.net/videos/girl-reading-book-in-library.mp4?fm=vtt&video-generate-subtitles=true&video-vtt-lang=jaライブデモ
以下の例は、個別の VTT サイドカーリクエストを使って英語、日本語、フランス語の字幕トラックを読み込みます。動画プレーヤーの字幕メニューを使って言語を切り替えてください。
完全な HTML の例については、ユーザーフレンドリーな動画プレーヤーの作成チュートリアルを参照してください。