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

CDN:ビデオシークの設定

最終更新日:Sep 05, 2026

ビデオシークは、ビデオの特定の時点にシークする際に、クライアントがサーバーに URL リクエストを送信するオンデマンドビデオ向けの機能です。本トピックでは、ビデオシーク機能を有効にする方法について説明します。

説明

ビデオシークを有効にすると、最初のバイトまでの時間 (TTFB) が約 30 ms 増加します。この遅延は通常、体感できるものではありません。

仕組み

ビデオシークが有効な場合、ユーザーが再生位置を調整するたびにサーバーにリクエストが送信されます。CDN は最も近い直前のキーフレームを特定して要求されたビデオセグメントを読み込み、シームレスな再生体験を提供します。

前提条件

  • オリジンサーバーが HTTP レンジリクエストをサポートしていること。

  • パラメーターの無視機能が無効になっていること。

ファイル形式とパラメーター

たとえば、クライアントが www.aliyun.com/test.flv?start=10 のような FLV ファイルの URL リクエストを送信すると、サーバーは 10 バイト目より前にあるキーフレームから始まるデータを返します。次の表に、ビデオシークでサポートされているファイル形式と URL 形式を示します。

ファイル形式

メタデータ

start パラメーター

例

MP4

オリジンサーバー上のビデオのメタデータは、ファイルヘッダーに配置する必要があります。ファイルの末尾にメタデータがあるビデオはサポートされていません。

start パラメーターは時間を秒単位で指定し、小数 3 桁までサポートします。たとえば、start=1.01 は、再生が 1.01 秒から始まることを示します。

  • 開始時間がキーフレーム上にない場合、CDN は自動的に直前のキーフレームにシークします。

  • 開始時間がキーフレームの場合、CDN は自動的にそのキーフレームにシークします。

domain/video.mp4?start=10 の URL リクエストは、再生が 10 秒目から始まることを意味します。

FLV

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

start パラメーターはオフセットをバイト単位で指定します。小数はサポートされていません。小数値を指定した場合、シークモジュールは最も近い整数に値を切り捨てます。[時間ベースの FLV ファイルシーク]を有効にすると、start パラメーターと end パラメーターは時間を秒単位で表します。

説明

バイトベースのシークは、正確なデータ処理や生のビデオワークフローに適していますが、時間ベースのシークは、特定の秒にジャンプできるため、ユーザーフレンドリーな体験を提供します。

  • 開始オフセットがキーフレーム上にない場合、CDN は自動的に直前のキーフレームにシークします。

  • 開始オフセットがキーフレームの場合、CDN は自動的にそのキーフレームにシークします。

domain/video.flv?start=10 の URL リクエストは、10 バイト目より前にあるキーフレームから再生を開始します。

操作手順

  1. Alibaba Cloud CDN コンソールにログインします。

  2. 左側のナビゲーションペインで [ドメイン名 ] をクリックします。

  3. [ドメイン名] ページで、管理対象のドメイン名を見つけ、[アクション] 列の [管理] をクリックします。

    ドメイン名

  4. ドメイン名の左側のナビゲーションウィンドウで、[ビデオ関連] をクリックします。

  5. ビデオシーク セクションで、ビデオシーク スイッチをオンにします。

  6. (オプション) 時間ベースの FLV ファイルシーク をオンにし、カスタムパラメーター を設定します。

シークパラメーターの処理

たとえば、時間単位のシークの場合、デフォルトのビデオシークパラメーターは 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 が動画の長さより大きい

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 が動画の長さより大きい

完全な動画を返します。