全部產品

：視頻處理

更新時間：Aug 05, 2025

在音ApsaraVideo for VOD情境下，ESA的視頻處理功能可以通過識別播放位置的最近前一個主要畫面格，以載入使用者希望播放的視頻片段，從而實現無縫切換的播放體驗。

前提條件

來源站點伺服器支援HTTP Range請求。
查詢字串需要設定為全部保留。

新增視頻處理規則

在ESA控制台，選擇網站管理，在網站列單擊目標網站。
在左側導覽列，選擇規則 > 內容最佳化規則。
選擇視頻處理頁簽，單擊新增規則，填寫規則名稱。
在如果請求匹配以下規則...地區設定要匹配的使用者請求特徵，具體配置規則請參見規則運算式的組成。

在拖拽播放地區，單擊配置，開啟狀態開關，根據業務需求填入對應的參數。

例如：FLV檔案的URL請求為www.aliyun.com/test.flv?start=10，服務端會響應從第10位元組前一個主要畫面格的資料。拖拽播放功能支援的檔案和URL格式如下表所示。

檔案格式

Meta資訊

參數

舉例

MP4

來源站點視頻的meta資訊必須在檔案頭部，不支援meta資訊在尾部的視頻。

start參數表示時間（秒），最多支援三位小數。例如start=1.01，表示1.01秒開始播放。

start不是主要畫面格，ESA會自動定位到前一個主要畫面格。
start是主要畫面格，ESA會自動定位到當前主要畫面格。

自訂MP4參數說明：

開始參數預設為start，結束參數預設為end。
自訂參數只能使用大小寫字母、數字及底線_。例如：123、aabbAABB、aa_BB123。

URL請求為domain/video.mp4?start=10，表示從第10秒開始播放視頻。

FLV

來源站點視頻必須帶有meta資訊。

start參數表示位元組，不支援小數，雖然參數可以寫小數，但是拖拽模組會向下取整把小數轉為正整數。

FLV按時間拖拽：則開始和結束參數的單位為秒。

按位元組拖拽：按位元組定址適合用於精確的資料處理或處理原始視頻資料，而按秒定址則通過直接跳轉到請求的精確秒數提供方便使用的體驗。

start不是主要畫面格，ESA會自動定位到前一個主要畫面格。
start是主要畫面格，ESA會自動定位到當前主要畫面格。

拖拽播放自訂參數說明：

開始參數預設為start，結束參數預設為end。
自訂參數只能使用大小寫字母、數字及底線_。例如：123、aabbAABB、aa_BB123。

URL請求為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`大於視頻時間長度	返回`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`大於視頻時間長度	返回完整視頻。

相關文檔

規則相關的功能，在生效優先順序、可重新進入性、生效顆粒度這三個特性上存在差異，詳細情況請查看規則相關功能的特性說明。