すべてのプロダクト
Search
ドキュメントセンター

:ビデオ処理

最終更新日:Jun 19, 2025

オンデマンドオーディオおよびビデオストリーミングのシナリオでは、ESA のビデオ処理機能は、再生位置の直前の最も近いキーフレームを識別して、ユーザーが再生したいビデオクリップを読み込み、シームレスな再生体験を提供します。

始める前に

  • オリジンサーバーは HTTP Range リクエストをサポートしている必要があります。

  • クエリ文字列すべて保持 に設定する必要があります。

ビデオ処理ルールの追加

  1. ESA コンソールで、[ウェブサイト] を選択し、管理するウェブサイトの名前をクリックします。

  2. 左側のナビゲーションウィンドウで、[ルール] > [コンテンツ最適化ルール] を選択します。

  3. [ビデオ処理] タブをクリックします。 [ルールを追加] をクリックし、[ルール名] に入力します。

  4. [リクエストが以下のルールと一致する場合...] 領域で、受信リクエストと一致する条件を指定します。ルールの構成方法の詳細については、「ルール」をご参照ください。

  5. [ビデオシーク] セクションで、[設定] をクリックし、[ステータス] スイッチをオンにして、パラメーターを構成します。

    image

    次のリストは、シーク再生とサンプル URL でサポートされているファイル形式を示しています。

    MP4 ファイル

    • メタデータ: オリジンサーバー上のビデオファイルのメタデータは、ファイルの末尾ではなく、ファイルヘッダーに含まれている必要があります。

    • パラメーター: start パラメーターは秒単位で時間を指定し、値は小数点以下 3 桁に四捨五入できます。たとえば、start=1.01 は、ビデオが 1.01 秒目から再生されることを示します。

      • start パラメーターで指定された位置がキーフレームでない場合、ESA は指定された位置の前にある最後のキーフレームを自動的に特定します。

      • start パラメーターで指定された位置がキーフレームでない場合、ESA はキーフレームを自動的に特定します。

    • カスタム MP4 パラメーター:

      • start パラメーターのデフォルト値は start で、end パラメーターのデフォルト値は end です。

      • カスタムパラメーター値には、文字、数字、およびアンダースコア (_) のみを含めることができます。

    • 例:

      domain/video.mp4?start=10: ビデオが 10 秒目から再生されることを示します。

    FLV ファイル

    • メタデータ: オリジンサーバー上のビデオファイルにはメタデータが含まれている必要があります。

    • パラメーター: start パラメーターは位置を指定します。 start パラメーターはバイト単位の値のみをサポートします。小数はサポートされておらず、値は最も近い正の整数に切り捨てられます。

      • FLV シーク

        • [時間単位でシーク]: start パラメーターと end パラメーターの単位は秒です。このメソッドは、指定された時点のビデオ画像に移動し、ユーザーフレンドリーなエクスペリエンスを提供します。

        • [バイト単位でシーク]: このメソッドは、正確なデータまたは生のビデオデータ処理に適しています。

          • start パラメーターで指定された位置がキーフレームでない場合、ESA は指定された位置の前にある最後のキーフレームを自動的に特定します。

          • start パラメーターで指定された位置がキーフレームでない場合、ESA はキーフレームを自動的に特定します。

    • カスタムビデオシークパラメーター:

      • start パラメーターのデフォルト値は start で、end パラメーターのデフォルト値は end です。

      • カスタムパラメーター値には、文字、数字、およびアンダースコア (_) のみを含めることができます。

    • 例:

      domain/video.flv?start=10: ビデオが 10 バイト目から再生されることを示します。

ビデオシークパラメーターの処理ロジック

時間によるシークを例として使用します。デフォルトの start パラメーターと end パラメーターが使用されます。次の表は、さまざまなシナリオにおけるパラメーター値の処理ロジックを示しています。

MP4 ファイルのリクエスト

start/end 値

処理ロジック

start パラメーターと end パラメーターの無効な値

start=foo&end=bar

ビデオシークパラメーターを無視し、ビデオ全体で応答します。

start パラメーターの有効な値と end パラメーターの無効な値

start=10

10 からファイルの末尾までビデオシークを処理します。

start パラメーターの無効な値と end パラメーターの有効な値

end=10

0-10 のビデオシークを処理します。

start パラメーターと end パラメーターの有効な値

start=0&end=10

0-10 のビデオシークを処理します。

start パラメーターと end パラメーターの両方が 0 に設定されている

start=0&end=0

ビデオシークパラメーターを無視し、ビデオ全体で応答します。

start パラメーターの値が end パラメーターの値よりも大きい

start=10&end=0

10 からファイルの末尾までビデオシークを処理します。

start パラメーターの値が end パラメーターの値と等しい

start=10&end=10

10 からファイルの末尾までビデオシークを処理します。

start パラメーターの値がビデオの長さよりも大きい

start パラメーターの値がビデオの長さよりも大きい

HTTP ステータスコード 400 で応答を返します。

FLV ファイルのリクエスト

start/end 値

処理ロジック

start パラメーターと end パラメーターの無効な値

start=foo&end=bar

ビデオシークパラメーターを無視し、ビデオ全体で応答します。

start パラメーターの有効な値と end パラメーターの無効な値

start=10

10 からファイルの末尾までビデオシークを処理します。

start パラメーターの無効な値と end パラメーターの有効な値

end=10

0-10 のビデオシークを処理します。

start パラメーターと end パラメーターの有効な値

start=0&end=10

0-10 のビデオシークを処理します。

start パラメーターと end パラメーターの両方が 0 に設定されている

start=0&end=0

ビデオシークパラメーターを無視し、ビデオ全体で応答します。

start パラメーターの値が end パラメーターの値よりも大きい

start=10&end=0

10 からファイルの末尾までビデオシークを処理します。

start パラメーターの値が end パラメーターの値と等しい

start=10&end=10

10 からファイルの末尾までビデオシークを処理します。

start パラメーターの値がビデオの長さよりも大きい

start パラメーターの値がビデオの長さよりも大きい

ビデオ全体を返します。