TikTok 擷取管道
執行 pipeline.sh。請勿自行推導 ffmpeg、mpv 或 Xvfb 指令,也不要嘗試用肉眼或時長判斷錄製是否成功。
唯一規則
絕不報告擷取成功。只有 pipeline.sh 能透過退出碼決定。
這點很重要,因為一個無聲遺失最後一秒的錄製,仍然會有完全正確的時長和完全正確的影格數。只有 verify.py 中的第一影格/最後影格比較能捕捉到它。如果你曾經想檢查時長或檔案大小就認為沒問題,那正是此管道要防止的失敗模式。
執行單一任務
OUT_DIR=/data/out ./pipeline.sh "https://www.tiktok.com/@user/video/123"
若需要 Cookie(當來源需要 Session 時):
OUT_DIR=/data/out COOKIES=/data/cookies.txt ./pipeline.sh "$URL"
執行批次任務
從佇列檔案中逐行讀取 URL 並迴圈處理。除非你已經檢查過 CPU 預算,否則應序列執行——每個任務大約需要 2 個 vCPU 才能維持 30fps 不掉幀,而且每個任務會根據自己的 PID 取得顯示編號和 PulseAudio 實例,因此並行執行不會衝突。
while read -r url; do
[ -z "$url" ] && continue
OUT_DIR=/data/out ./pipeline.sh "$url" || echo "失敗: $url"
done < queue.txt
退出碼
| 碼 | 意義 | 應採取的行動 |
|---|---|---|
| 0 | 驗證通過 | 記錄輸出路徑。無需其他操作。 |
| 3 | 缺少依賴 | 停止並回報。不可重試。 |
| 10 | 下載失敗 | 預期情況。影片被封鎖、設為私人或已刪除。記錄並繼續。 |
| 11 | 來源無音訊 | 記錄並繼續。 |
| 12 | 轉碼失敗 | 記錄。重試一次,然後回報。 |
| 13 | 擷取失敗 | 檢查 Xvfb/pulseaudio 是否已安裝,且顯示範圍是否可用。 |
| 14 | 修剪失敗 | 無法測量或驗證前導片段。回報;不要盲目重試。 |
| 15 | 驗證失敗 | 輸出位於 <output>.rejected。回報為管道缺陷。 |
退出碼 10 是常規情況,並非事故。在資料中心 IP 上,對於大部分 URL 來說這是預期結果。將其回報為一個計數,不要迴圈重試。
當反覆失敗時
退出碼 14 或 15 表示管道本身有問題,而不是影片的問題。讀取該次執行的 manifest.json 測量數據——first_frame_mae 和 last_frame_mae 可以區分兩種情況:
- 最後影格 MAE 高,第一影格 MAE 低 → 前導片段測量過短,導致結尾被截斷。
- 兩者都高 → 擷取對齊不準確,或顯示畫面從未更新。
請回報這些數值,而不是調整容差值來強制通過。提高 --match-threshold 以獲得綠色結果並不是修復方法。