imgix.videoからImgix Videoへの移行
動画配信はimgix.net— すでにImgixの画像配信で使用されているものと同じドメイン — に統合されます。現在.imgix.videoサブドメインで動画を配信している場合、このガイドではカットオーバー日までにimgix.net上のImgix Videoへ移行する手順を説明します。ほとんどのアカウントでは、移行は単純な1ステップのサブドメイン変更だけで完了します。imgix.video固有のパラメータを使用している場合は、いくつかのパラメータをImgix Videoの相当パラメータに変換する必要があります。
Imgix Videoで得られるもの
imgix.netに移行すると、URLだけでimgix.videoにはなかった多くの機能を利用できるようになります:
- AIによる字幕とオーバーレイテキストの自動生成 — 動画の音声を文字起こしし、複数の言語に翻訳します。字幕スタイルのカスタマイズも可能です
- 動画プレビュー — Imgixが動画から最も特徴的な場面を自動的に選び出し、短く魅力的なプレビューを作成します
- 高品質なエンコーディング — 知覚品質の目標値を設定するだけで、Imgixがその品質を満たす最小のファイルサイズを見つけます
- 音声コントロール — ソースファイルを編集し直すことなく、ノイズ除去、音量の正規化、フェードイン/フェードアウト、音量調整、ミュートが可能です
- フレーム補間 — 低フレームレートの素材からでも、AIによる中間フレーム生成でスムーズなスローモーションや高フレームレートを実現します
- ピクチャーインピクチャー — 「次の動画」プレビュー、リアクション動画、マルチカメラ映像などのために、2つ目の動画を重ねて表示できます
動画も画像と同じプラットフォーム上で動作するため、すべてのビジュアルアセットを一つのワークフローで扱えるようになります。
前提条件
開始する前に、以下を確認してください:
- 動画URLが生成またはハードコードされている場所(コードベース、CMS、またはCDN設定)へのアクセス権
- アカウントで使用しているすべての
.imgix.videoサブドメインのリスト(開発/ステージング/本番の各バリエーションを含む)
すべての.imgix.video参照を見つける
コードベース、CMS、またはテンプレート内で.imgix.videoドメイン文字列を検索してください。見つかったサブドメインはすべて移行してください — アカウントによっては複数のサブドメインを使用している場合があります(例: 本番用とステージング用で別のサブドメイン)。
サブドメインを変更する
各URLの.imgix.videoを.imgix.netに置き換えてください。パスとすべてのクエリパラメータはそのまま変わりません:
変更前: https://your-subdomain.imgix.video/path/to/video.mp4?fm=mp4
変更後: https://your-subdomain.imgix.net/path/to/video.mp4?fm=mp4w、h、fit、auto、q、fm=mp4などの標準的なレンダリングパラメータは、Imgix Videoでも同一であり、変更の必要はありません。
imgix.video固有のパラメータを変換する
動画URLで以下のimgix.video固有のパラメータを使用している場合は、Imgix Videoの相当パラメータに変換してください:
| imgix.videoのパラメータ | Imgix Videoでの相当パラメータ |
|---|---|
video-generate=thumbnail + video-thumbnail-time=N | video-thumbnail=N + fm=jpg |
res=low / res=medium / res=high | w=720 / w=1280 / w=1920 |
video-generate=storyboard + video-storyboard-format=<fmt> | fm=spritesheet + video-spritesheet-format=<fmt> |
video-generate=gif + video-gif-fps=N + video-gif-start/video-gif-end | video-generate=gif + fps=N + video-clip-start/video-clip-end |
vdl | dl=filename — ダウンロードを強制し、ダウンロード時のファイル名を指定できます |
gif-q | q — 同じ1〜100の品質スケール |
これらのパラメータを使用していない場合は、このステップは不要です — 単純なサブドメイン変更だけで完了します。
動作に関するいくつかの注意点を確認する
移行したURLをテストする際に、以下の点に注意してください:
- HLS配信:
fm=hlsはImgix Videoで完全にサポートされています — 特別なアクセス権は不要です。 - 動画の長さ: 最大30分の動画をサポートしています。
- 長い動画は非同期で処理されます: 2分を超える動画はバックグラウンドでエンコードされます。新しいURLへの最初のリクエストは、動画が準備されている間
423ステータスを返します。以降のリクエストは、キャッシュから完成した動画を返します。これはエラーではなく想定された動作です — URLをポーリングするか、数分後に再度確認してください。
カットオーバー前にテストする
移行した各URLをリクエストし、200レスポンス(または最初のリクエストで想定される423)が返ることを確認してください。出力(サイズ、フォーマット、サムネイルのフレーム)を元のimgix.video URLと比較して、一致することを確認してください。
デプロイする
移行したURLを確認できたら、サブドメイン変更を本番環境へ展開してください。.imgix.videoのURLはサンセット日以降解決できなくなるため、スタック内にキャッシュされた古い参照が残っていないことを確認してください。
参考資料
特定の移行についてご質問がある場合は、Imgixサポートまでお問い合わせください。