TikTokキャプチャパイプライン
pipeline.sh を実行してください。ffmpeg、mpv、Xvfb のコマンドを自分で再導出したり、録画が成功したかどうかを目視や再生時間で判断しようとしないでください。
唯一のルール
キャプチャが成功したと絶対に報告しないでください。成功を判断するのは pipeline.sh の終了コードだけです。
これは重要です。なぜなら、最後の1秒が無音で失われる録画でも、再生時間とフレーム数は正確に一致するからです。それを検出できるのは verify.py による先頭フレームと最終フレームの比較だけです。再生時間やファイルサイズをチェックして「問題なし」と判断したくなる誘惑に駆られたなら、まさにこのパイプラインが防止しようとしている失敗が起きています。
単一ジョブの実行
OUT_DIR=/data/out ./pipeline.sh "https://www.tiktok.com/@user/video/123"
ソースがセッションを必要とする場合、クッキーを使用:
OUT_DIR=/data/out COOKIES=/data/cookies.txt ./pipeline.sh "$URL"
バッチ処理
キュー・ファイルから1行に1つのURLを読み取り、ループで処理します。CPUリソースを確認していない限り、逐次実行してください。各ジョブは30fpsを維持しフレーム落ちを防ぐために約2 vCPUを必要とし、各ジョブは自身のPIDに基づいた表示番号とPulseAudioインスタンスを使用するため、並行実行しても衝突しません。
while read -r url; do
[ -z "$url" ] && continue
OUT_DIR=/data/out ./pipeline.sh "$url" || echo "FAILED: $url"
done < queue.txt
終了コード
| コード | 意味 | すべきこと |
|---|---|---|
| 0 | 検証済み | 出力パスを記録。他にすることはありません。 |
| 3 | 依存関係の欠落 | 停止して報告。再試行不可。 |
| 10 | ダウンロード失敗 | 想定内。ブロック、非公開、または削除済み。ログを記録して次へ進む。 |
| 11 | ソースに音声なし | ログを記録して次へ進む。 |
| 12 | トランスコード失敗 | ログを記録。1回再試行後、報告。 |
| 13 | キャプチャ失敗 | Xvfb/pulseaudio がインストールされ、表示範囲が空いていることを確認。 |
| 14 | トリミング失敗 | リードインを測定または検証できませんでした。報告。盲目的な再試行はしない。 |
| 15 | 検証失敗 | 出力は <output>.rejected にあります。パイプラインの欠陥として報告。 |
終了コード 10 は日常的なものであり、インシデントではありません。データセンターのIPアドレスでは、多くのURLでこれが想定される結果です。数を報告し、ループ内で再試行しないでください。
繰り返し失敗する場合
終了コード 14 または 15 は、動画ではなくパイプライン自体に問題があることを意味します。実行時の manifest.json の測定値(first_frame_mae と last_frame_mae)が2つのケースを区別します。
- last frame MAE 高、first frame MAE 低 → リードインの測定が短く、終了部分が切り詰められています。
- 両方とも高い → キャプチャがずれているか、ディスプレイが更新されていません。
許容値を調整してパスを強制するのではなく、数値を報告してください。--match-threshold を上げて結果を成功にすることは修正ではありません。