Imgix Video is now live! Learn more about our latest release here. →
Imgix APIs動画 APIロングフォーム動画

ロングフォーム動画

プレミアム機能

この機能は現在、Imgix のプレミアムプランをご利用のお客様のみご利用いただけます。ご興味のある方は、営業チームにお問い合わせください。

ロングフォーム動画 機能では、動画を HTTP ライブストリーミング（HLS） 形式に変換し、あらゆるブラウザ、あらゆるデバイスで Web プレーヤーを使用して視聴できるようにします。

このドキュメントセクションでは、ロングフォーム動画で使用可能なすべてのパラメータを説明し、コードサンプルも掲載しています。Web プレーヤーの設定など動画の実装に関する手順については、チュートリアルセクションをご参照ください。

ロングフォーム動画の違い

  • ロングフォーム動画は .video ドメイン拡張子で提供されます。例：https://assets.imgix.video/videos/girl-reading-book-in-library.mp4?fm=hls
  • ロングフォーム動画は カスタムドメインをサポートしていません
  • ストリーミング動画の再生には、互換性のある Web プレーヤーが必要な場合があります。Imgix では ix-elements を通じて Web プレーヤーを提供しています。
  • 新しくアップロードされた動画は、Imgix によって処理 されてから URL API を通じて利用可能になります。処理時間は動画の長さに依存しますが、通常は数秒から数分で完了します。まだ準備が整っていない動画は 423 Processing ステータスコードを返します。ステータスはアセットマネージャーで確認するか、動画 URL をポーリングして確認できます。

動画処理

動画を再生可能にするには、まず Source の Origin にアップロードされた動画を Imgix のサービスで処理（トランスコード）する必要があります。この処理により、複数の形式や解像度に変換され、最適なストリーミングパフォーマンスが実現されます。

トランスコードを開始する方法はいくつかあります：

  • Load to encode：最も一般的な方法で、リクエストされた動画のみをキューに登録します。
  • アセットマネージャーでのアップロード：Asset Manager 経由でアップロードされた動画は自動的にトランスコードされます。
  • .video ドメイン拡張子を使用して動画にリクエストを送ると、トランスコード処理が開始され 423 Processing を返します。
  • Origin のクロール：新しい動画を定期的に検出。多くの動画を頻繁に更新するユーザー向け。利用には サポートチーム への連絡が必要です。

トランスコード完了後にロングフォーム動画パラメータを適用できます。

処理時間は動画の長さに応じて変動し、アセットマネージャーで以下のステータスで確認できます：

  • Processing：処理中
  • Processed：処理完了。imgix.video ドメインで配信可能
  • Error：処理中に問題が発生

動画のエンコードは 1 回限りで行われ、Origin 上の動画に変更がない限り再エンコードは不要です。再処理には refresh エンドポイント を使用してください。

動画が非互換であったり、アクセスに問題がある場合は error 状態になります。安定したトランスコードのため、アップロード後にファイル名の変更や削除は避けてください。

HTTP Live Streaming (HLS) の仕組み

HTTP Live Streaming（HLS）は、動画コンテンツをインターネットでストリーミングするためのプロトコルです。動画を小さなチャンクに分割して HTTP 経由で配信することで、アダプティブビットレートストリーミングが可能になります。

.video ドメインで HLS を使用して動画をリクエストすると、インターネット接続に応じた最適なビットレートでチャンクが返され、視聴環境に応じて自動的に画質が調整されます。

字幕

ロングフォーム動画では字幕が自動生成されます。

字幕の有効化方法は使用する動画プレーヤーによって異なりますが、通常は動画右下に表示される設定からオンにできます。Imgix を含む多くのプレーヤーでは自動的に字幕を認識します。

対応言語：

  • ブルガリア語
  • カタルーニャ語
  • クロアチア語
  • チェコ語
  • デンマーク語
  • オランダ語
  • 英語
  • フィンランド語
  • フランス語
  • ドイツ語
  • ギリシャ語
  • イタリア語
  • ノルウェー語
  • ポーランド語
  • ポルトガル語
  • ルーマニア語
  • ロシア語
  • スロバキア語
  • スペイン語
  • スウェーデン語
  • トルコ語
  • ウクライナ語

字幕は Source ダッシュボードの設定 から有効化できます。

動画エンコードの字幕設定

ウォーターマーク

ウォーターマーク機能では、動画にロゴや画像を重ねて表示することができます。この設定は Video 機能が有効な Source の設定画面から行います。位置、サイズ、不透明度の調整が可能です。

設定は Source ダッシュボードの設定 から行います。

動画エンコードのウォーターマーク設定

以下の例では、Imgix ロゴ を動画の右下に表示する設定です。

動画のウォーターマーク設定を更新したい場合は、リフレッシュ機能を使うか サポートに連絡 して再処理を依頼してください。

すべてまたはなしのウォーターマーキング

ウォーターマーク機能は「すべてまたはなし」で適用されます。Source でウォーターマークを有効にすると、その Source に含まれるすべての動画に適用されます。

一部の動画のみにウォーターマークを適用したい場合は、同じ Origin を指す新しい Source を作成し、その新しい Source でウォーターマークを有効にしてください。

動画の削除

Rendering API とは異なり、動画は引き続き Origin 上の存在を確認されます。Origin から動画を削除すると：

  • 動画 URL は再生できなくなります
  • アセットマネージャー上のステータスが deleted に変わります

対応動画ファイル形式

あらゆる動画ファイル形式に対応しています。正常な処理のためには、動画のメタデータおよび Origin からのレスポンスヘッダーに適切なコンテンツタイプが定義されている必要があります。

1 ファイルあたりの最大再生時間は 12 時間です。動画入力の標準化については、動画パフォーマンス最適化ガイドをご参照ください。

制限事項

動画キャッシュ

動画コンテンツに対するキャッシュ構成は Imgix が直接制御しておらず、cache-control ヘッダーも影響しません。HLS の .ts チャンクや MP4 のような動画形式に応じてキャッシュ動作が異なり、最適な体験を提供するために変化する可能性があります。

Web プレーヤーでの使用

すべてのブラウザが HLS に対応しているわけではありません。対応していないブラウザでは、ロングフォーム動画を開くとストリームのチャンクをダウンロードする可能性があります。

HLS 動画の再生には、HLS 再生に対応した Web プレーヤーを使用する必要があります。これにより、同じ動画 URL をすべてのブラウザやデバイスで使用できます。

以下は、ix-elements ライブラリを使用して Imgix の動画をストリーミングするコード例です：

<!-- Note: type 'module' here is important -->
<script
  defer
  type="module"
  src="https://static.imgix.net/ix-player/@latest/dist/ix-player.mjs"
></script>
<ix-player
  gif-preview
  type="hls"
  src="https://assets.imgix.video/videos/girl-reading-book-in-library.mp4?ixembed=docs&fm=hls"
>
</ix-player>

Click here to modify this in a CodeSandbox.

動画プレーヤーに関する詳細は、ユーザーフレンドリーな動画プレーヤー作成チュートリアルをご覧ください。

ビデオの幅フォーマット