Render-Video-Workflow
Rendering ist der Prozess, bei dem eine Komposition Bild für Bild erfasst und in eine Videodatei (z.B. MP4) kodiert wird. Dies geschieht mit dem Paket @helios-project/renderer in einer Node.js-Umgebung.
Der schnelle Weg: Ein Befehl
npx -y @helios-project/cli@latest render composition.html -o output.mp4
- Dauer, fps und Größe stammen aus
window.heliosder Komposition. Wenn Sie diese selbst festlegen möchten, übergeben Sie--duration,--fps,--widthund--height. - Eine Seite, die sich selbst mit
window.renderAt(t)zeichnet, benötigt--duration. --audio track.mp3fügt einen Soundtrack hinzu.- Eine einfache HTML-Datei wird direkt von der Festplatte gerendert. Wenn ein Bundler die Komposition erstellen muss, führen Sie
npm run devaus und übergeben Sie stattdessen die URL.
Verwenden Sie das folgende Skript nur, wenn Sie eine benutzerdefinierte Pipeline benötigen, z.B. Eingabeeigenschaften, mehrere Audiospuren oder Fortschritts-Callbacks.
1. Voraussetzungen
Der Renderer benötigt eine URL für die Komposition:
- Eine Datei auf der Festplatte:
file:///pfad/zu/komposition.html - Ein Dev-Server:
npm run dev, z.B.http://localhost:3000/komposition.html - Jede andere erreichbare URL
2. Render-Skript erstellen
Erstellen Sie eine Datei namens render.js (oder render.ts, wenn Sie ts-node verwenden).
import { Renderer } from '@helios-project/renderer';
import path from 'path';
async function main() {
// 1. Konfiguration
const compositionUrl = 'http://localhost:3000/komposition.html';
const outputPath = path.resolve('output.mp4');
// 2. Renderer initialisieren
const renderer = new Renderer({
width: 1920,
height: 1080,
fps: 30,
durationInSeconds: 10,
// frameCount: 300, // Optional: Überschreibt durationInSeconds mit einer exakten Bildanzahl
mode: 'canvas', // Verwenden Sie 'dom', wenn Ihre Animation CSS/HTML-Elemente verwendet
// Audio-Konfiguration
audioTracks: [
{ path: 'hintergrund.mp3', volume: 0.5 },
{ path: 'sprachaufnahme.wav', offset: 2 }
],
audioCodec: 'aac',
// Eingabeeigenschaften (dynamischer Inhalt)
inputProps: {
titel: "Benutzerdefinierter Render",
farbe: "#00ff00"
}
});
console.log(`Starte Rendern von ${compositionUrl}...`);
// 3. Render ausführen
try {
await renderer.render(compositionUrl, outputPath, {
onProgress: (p) => {
const percent = Math.round(p * 100);
process.stdout.write(`\rFortschritt: ${percent}%`);
}
});
console.log(`\nFertig! Gespeichert unter ${outputPath}`);
} catch (err) {
console.error('\nRendering fehlgeschlagen:', err);
process.exit(1);
}
}
main();
3. Render ausführen
Führen Sie das Skript aus.
# Wenn ts-node verwendet wird
npx ts-node render.ts
# Wenn node verwendet wird (kompilierte js)
node render.js
Fehlerbehebung
"Page timeout" oder "Connection refused"
- Stellen Sie sicher, dass der lokale Server, der die Komposition hostet, läuft.
- Überprüfen Sie, ob die URL korrekt und in einem normalen Browser erreichbar ist.
"Schwarze Ausgabe" oder "Leeres Video"
- Stellen Sie sicher, dass
window.heliosverfügbar ist (oder die Seitewindow.renderAt(t)definiert). - Wenn Sie
mode: 'canvas'verwenden, stellen Sie sicher, dass Sie auf ein<canvas>-Element zeichnen. - Wenn Sie
mode: 'dom'verwenden, stellen Sie sicher, dass die Elemente sichtbar sind.
"Rendering hängt"
- Überprüfen Sie, ob die Komposition Fehler in der Browser-Konsole aufweist.
- Aktivieren Sie Tracing zum Debuggen:
await renderer.render(url, out, { tracePath: 'trace.zip' });
Audioprobleme
- Stellen Sie sicher, dass die Pfade zu den Audiodateien relativ zu dem Ort, an dem das Skript ausgeführt wird, korrekt sind.
- Wenn Sie
mode: 'dom'verwenden und sich auf implizite Audioquellen (z.B.<audio>-Tags) verlassen, stellen Sie sicher, dass die Elemente im DOM vorhanden sind.