ApsaraVideo VOD：非同步任務處理說明

關於"總完成時間長度"與"處理時間長度"的區別

這是理解非同步任務時效的關鍵。

文檔中出現的處理速度、倍速、樣本分鐘數，僅用於描述任務進入實際處理階段後的處理速度特徵。

使用者最終感知到的"多久可以拿到結果"，取決於：

1. 任務進入實際處理前經歷了多久等待。

2. 任務本身實際處理了多久。

因此：

• 處理時間長度參考值 ≠ 任務總完成時間長度。

• 處理時間長度參考值不能直接用於推導任務交付時點。

• 同規格任務在不同時段提交，總完成時間長度可能存在明顯差異。

通用等待時間長度說明

任務提交後，服務端會根據任務類型、任務量及處理策略安排任務進入實際處理階段。

在以下情況下，等待時間可能增加：

• 短時間內集中提交大量任務。

• 同一時段任務量波動較大。

• 高複雜度任務佔比較高。

如需瞭解當前產品服務狀態，可通過以下方式擷取：

• 等待時間長度的長短受任務量、任務特徵等多種因素影響，單純的等待時間增加不能直接作為判斷服務異常的依據。如需確認當前服務狀態，建議請求支援人員協助判斷。

• 若出現影響範圍較大的服務異常，阿里雲將通過站內信、簡訊等方式通知受影響使用者。

通用實際處理時間長度說明

實際處理時間長度與任務類型、源檔案特徵及任務配置密切相關，不同能力的耗時模型並不完全相同。

轉碼任務狀態說明

以提交轉碼任務為例，任務查詢結果中的狀態欄位可能顯示為 Transcoding（轉碼中）。

需要注意的是，Transcoding 表示任務已進入轉碼處理流程，但不一定表示已經開始實際轉碼。

可結合 TranscodeProgress 欄位進一步判斷任務所處階段：

對於轉碼任務，等待中通常不是獨立的狀態枚舉，而是結合任務狀態與轉碼進度共同判斷的階段性狀態。

轉碼任務處理速度參考

以 H.264 720P的典型轉碼情境為參考，不同轉碼演算法的處理速度特徵如下：

倍速 = 每單位處理時間可完成的視頻時間長度倍數

樣本：
3 倍速表示每 1 分鐘處理時間可完成約 3 分鐘視頻內容
則 30 分鐘視頻在不考慮等待時間長度的前提下，處理階段理論耗時約為 10 分鐘

1. 一個 10 分鐘的 720P 轉碼任務，是否一定會在 3～4 分鐘內完成？

不一定。

"約 3 倍速"的參考值僅用於說明典型測試條件下，轉碼任務進入實際處理階段後的處理速度特徵，不包含任務進入實際處理前的等待時間，也不代表生產環境中的任務總完成時間長度。

客戶實際感知到的結果可用時間以任務最終完成時間為準，不建議依據處理速度參考值直接推導任務交付時點。

如任務總耗時超出業務預期，建議參考通用排查建議章節進行排查，或請求支援人員。

2. 為什麼我的轉碼任務狀態顯示為 Transcoding，但 TranscodeProgress 一直是 0？

因為對於轉碼任務，Transcoding 表示任務已進入轉碼處理流程，但並不等同於已經開始實際轉碼。

當 TranscodeProgress = 0 時，表示任務尚處於等待階段；當 TranscodeProgress > 0 時，表示任務已進入實際轉碼處理階段。

3. 為什麼我的工作規格與參考情境接近，但實際完成時間明顯更長？

可能原因包括但不限於：

• 任務在進入實際處理前經歷了較長等待

• 源檔案實際特徵與典型參考情境存在差異

• 任務參數或模板配置高於常規複雜度

• 同時段任務量波動導致總完成時間上升

如需進一步確認原因，建議請求支援人員並提供任務ID協助排查。

4. 等待時間增加是否一定代表格服務異常？

不一定。

等待時間長度的長短受任務量、任務特徵等多種因素影響，單純的等待時間增加不能直接作為判斷服務異常的依據。如需確認當前服務狀態，建議請求支援人員協助判斷。

5. 我能否依據處理速度參考值來承諾我的業務交付時間？

不建議。

處理速度參考值僅用於協助理解任務處理特徵，不應直接作為生產環境交付時間、業務 SLA 或對終端使用者的承諾依據。

對於存在嚴格時效要求的業務情境，建議在業務架構中預留緩衝時間，並設定逾時兜底與降級機制。

6. 其他非同步任務是否也能按轉碼任務的狀態方式判斷？

不一定。

轉碼任務樣本中的 Transcoding 與 TranscodeProgress 為轉碼任務特有的樣本口徑。

對於剪輯、截圖、雪碧圖、媒資分析及其他非同步任務，其狀態欄位、進度欄位和判斷方式可能與轉碼任務不同，請以具體任務的查詢介面和產品文檔為準。

發起任務

使用者通過 API 提交非同步任務後，服務端會返回任務ID。

任務 ID 是查詢狀態、關連接果通知及排查問題的唯一標識，請妥善儲存。

結果通知

任務處理完成後，如已配置回調地址，服務端可主動推送結果通知。使用者可基於回調自動感知任務完成情況，無需持續輪詢。

查詢任務

使用者可通過任務 ID 主動查詢任務目前狀態及處理結果，適用於以下情境：

• 未配置回調通知。

• 已配置回調，但需主動確認當前進度。

• 任務耗時超出業務預期。

• 回調通知接收失敗時作為兜底方式。

關於任務資訊的查詢

當前查詢介面主要返回任務狀態、進度及結果資訊。若任務耗時明顯超出業務預期，建議結合任務狀態變化、提交時間及任務配置進行排查；如仍無法判斷原因，可請求支援人員提供任務 ID協助分析。

1：確認任務是否已完成

通過任務 ID 查詢任務目前狀態或結果：

• 若任務已完成，擷取結果並評估總耗時。

• 若任務失敗，請查看錯誤碼和錯誤資訊。

• 若任務仍未完成，請繼續結合具體任務類型判斷是否處於等待或處理中階段。

2：結合任務類型判斷當前階段

• 對於轉碼任務：可結合 Transcoding 狀態與 TranscodeProgress 判斷是否進入實際轉碼處理階段。

• 對於其他非同步任務：請以對應任務的查詢介面返回欄位和文檔說明為準，不應直接套用轉碼任務的判斷方式。

3：結合任務特徵初步判斷可能原因

4：請求支援人員時建議提供的資訊

如需支援人員協助排查，請盡量提供以下資訊：

• 任務 ID。

• 任務提交時間。

• 任務類型（轉碼、剪輯、截圖、分析等）。

• 源檔案時間長度、解析度、編碼格式。

• 模板配置或處理參數。

• 是否批量提交。

• 問題現象及影響範圍。

整合建議

• 生產環境建議優先使用非同步回調。

• 避免高頻輪詢，以減少無效請求。

• 提交任務時應做好等冪控制，避免重複提交。

• 批量任務建議錯峰提交，避免短時間集中排隊。

• 建議建立任務逾時監控、警示和人工兜底機制。

• 對關鍵業務情境請預留足夠緩衝時間，並設計業務降級方案。

• 不要將處理速度參考值直接用於生產交付承諾。