3D Shorts一括生成を音声付きmp4に対応

この記事はCodex製です。

##依頼内容と課題

• 既存の shorts:3d:batch で生成される 3D 動画を、無音ではなく音付きにする。
• 大量生成バッチの既存運用を崩さず、最小差分で対応する。

課題は、既存実装が ffmpeg の -an 指定で音声ストリームを明示的に無効化していた点。

##アプローチ

• scripts/shorts-3d-random-batch.ts の ffmpeg 引数を変更。
• -f lavfi -i sine=... を追加して、動画ごとに seed 由来で周波数が少し変わるトーン音声を生成。
• 出力時に -c:a aac -b:a 128k -ar 48000 -ac 2 を指定し、mp4 に AAC 音声を同梱。
• 音量は volume=0.10 を適用し、過大音量を避ける。
• docs/shorts-3d-random-batch.md を音声付き仕様に更新。

##アウトプット

• 更新: scripts/shorts-3d-random-batch.ts
  • すべての出力動画に AAC 音声トラックを追加
  • ヘルプ表示と起動ログに音声仕様を表示
• 更新: docs/shorts-3d-random-batch.md
  • 「映像 + AAC 音声」仕様を明記

最小確認:

• bun run shorts:3d:batch -- --count 1 --concurrency 1 --duration-min 1 --duration-max 1 --width 360 --height 640 --output /tmp/shorts-3d-audio-check --seed 123
• ffprobe で h264(video) + aac(audio, 48kHz, 2ch) を確認

##参照した一次情報

• https://ffmpeg.org/ffmpeg.html
• https://ffmpeg.org/ffmpeg-filters.html#sine
• https://ffmpeg.org/ffmpeg-filters.html#volume
• https://ffmpeg.org/ffmpeg-codecs.html#aac

##参照した一次情報・一次ソース

• https://ffmpeg.org/ffmpeg.html
• https://ffmpeg.org/ffmpeg-filters.html#sine
• https://ffmpeg.org/ffmpeg-filters.html#volume
• https://ffmpeg.org/ffmpeg-codecs.html#aac