// Áudio opcional fornecido pelo usuário. Composto no FFmpeg, fora da Godot. // Não gera narração nem integra com Applio: só aceita um arquivo indicado. import fs from "node:fs"; import { resolveFromRoot } from "./paths.ts"; import { runProcess, succeeded, describeFailure } from "./process.ts"; import type { Tool } from "./tools.ts"; export type AudioConfig = { enabled: boolean; file: string | null; offsetSeconds?: number }; export type AudioPlan = { file: string; sourceDurationSeconds: number; offsetSeconds: number; sceneDurationSeconds: number; /** Segundos do áudio que ficariam além do fim da cena e serão cortados. */ cutSeconds: number; warnings: string[]; }; export class AudioError extends Error {} export async function planAudio(audio: AudioConfig | undefined, sceneDurationSeconds: number, ffprobe: Tool): Promise { if (!audio || !audio.enabled) return null; if (!audio.file) throw new AudioError("audio.enabled = true, mas audio.file está vazio"); const file = resolveFromRoot(audio.file); if (!fs.existsSync(file) || !fs.statSync(file).isFile()) { throw new AudioError(`arquivo de áudio não encontrado: ${audio.file} (caminhos relativos partem da raiz do projeto)`); } const r = await runProcess(ffprobe.path, ["-v", "error", "-show_entries", "format=duration", "-of", "default=noprint_wrappers=1:nokey=1", file], { timeoutMs: 60_000 }); if (!succeeded(r)) throw new AudioError(describeFailure("ffprobe (áudio)", r)); const duration = Number(r.stdout.trim()); if (!Number.isFinite(duration) || duration <= 0) throw new AudioError(`não foi possível obter a duração de ${audio.file}`); const offset = audio.offsetSeconds ?? 0; const cut = Math.max(0, offset + duration - sceneDurationSeconds); const warnings: string[] = []; if (cut > 0.0005) { warnings.push(`o áudio termina ${cut.toFixed(2)} s depois do fim da cena e será CORTADO em ${sceneDurationSeconds} s (a duração da cena não foi alterada; ajuste durationSeconds ou o áudio se quiser ouvir tudo)`); } return { file, sourceDurationSeconds: duration, offsetSeconds: offset, sceneDurationSeconds, cutSeconds: cut, warnings }; } /** * Argumentos do FFmpeg para o áudio (entrada #1). O áudio é atrasado pelo * offset, completado com silêncio e limitado à duração da cena. Sem -shortest: * o vídeo nunca é truncado quando o áudio acaba antes. */ export function audioFfmpegArgs(plan: AudioPlan): { inputs: string[]; mapping: string[] } { const delayMs = Math.round(plan.offsetSeconds * 1000); const filter = `[1:a]adelay=delays=${delayMs}:all=1,apad,atrim=end=${plan.sceneDurationSeconds},asetpts=PTS-STARTPTS[aout]`; return { inputs: ["-i", plan.file], mapping: ["-filter_complex", filter, "-map", "0:v", "-map", "[aout]", "-c:a", "aac", "-b:a", "192k", "-ar", "48000"], }; }