Workflow de rendu vidéo
Le rendu est le processus de capture d'une composition image par image et de son encodage en fichier vidéo (par ex. MP4). Cela se fait à l'aide du package @helios-project/renderer dans un environnement Node.js.
Le chemin rapide : une seule commande
npx -y @helios-project/cli@latest render composition.html -o output.mp4
- La durée, les fps et la taille proviennent de
window.heliosde la composition. Pour les définir vous-même, passez--duration,--fps,--widthet--height. - Une page qui se dessine avec
window.renderAt(t)a besoin de--duration. --audio track.mp3ajoute une bande sonore.- Un fichier HTML simple est rendu directement depuis le disque. Si un bundler doit construire la composition, exécutez
npm run devet passez son URL à la place.
Utilisez le script ci-dessous uniquement lorsque vous avez besoin d'un pipeline personnalisé, comme des props d'entrée, plusieurs pistes audio ou des rappels de progression.
1. Prérequis
Le renderer a besoin d'une URL pour la composition :
- Un fichier sur le disque :
file:///path/to/composition.html - Un serveur de développement :
npm run dev, par ex.http://localhost:3000/composition.html - Toute autre URL accessible
2. Créer un script de rendu
Créez un fichier nommé render.js (ou render.ts si vous utilisez ts-node).
import { Renderer } from '@helios-project/renderer';
import path from 'path';
async function main() {
// 1. Configuration
const compositionUrl = 'http://localhost:3000/composition.html';
const outputPath = path.resolve('output.mp4');
// 2. Initialiser le Renderer
const renderer = new Renderer({
width: 1920,
height: 1080,
fps: 30,
durationInSeconds: 10,
// frameCount: 300, // Optionnel : Remplace durationInSeconds par un nombre exact d'images
mode: 'canvas', // Utilisez 'dom' si votre animation utilise des éléments CSS/HTML
// Configuration audio
audioTracks: [
{ path: 'background.mp3', volume: 0.5 },
{ path: 'voiceover.wav', offset: 2 }
],
audioCodec: 'aac',
// Props d'entrée (contenu dynamique)
inputProps: {
title: "Rendu personnalisé",
color: "#00ff00"
}
});
console.log(`Début du rendu de ${compositionUrl}...`);
// 3. Exécuter le rendu
try {
await renderer.render(compositionUrl, outputPath, {
onProgress: (p) => {
const percent = Math.round(p * 100);
process.stdout.write(`\rProgression : ${percent}%`);
}
});
console.log(`\nTerminé ! Enregistré dans ${outputPath}`);
} catch (err) {
console.error('\nÉchec du rendu :', err);
process.exit(1);
}
}
main();
3. Exécuter le rendu
Exécutez le script.
# Si vous utilisez ts-node
npx ts-node render.ts
# Si vous utilisez node (js compilé)
node render.js
Dépannage
« Page timeout » ou « Connection refused »
- Assurez-vous que le serveur local hébergeant la composition est en cours d'exécution.
- Vérifiez que l'URL est correcte et accessible dans un navigateur normal.
« Sortie noire » ou « Vidéo vide »
- Assurez-vous que
window.heliosest exposé (ou que la page définitwindow.renderAt(t)). - Si vous utilisez
mode: 'canvas', assurez-vous de dessiner sur un élément<canvas>. - Si vous utilisez
mode: 'dom', assurez-vous que les éléments sont visibles.
« Le rendu se bloque »
- Vérifiez si la composition contient des erreurs dans la console du navigateur.
- Activez le traçage pour déboguer :
await renderer.render(url, out, { tracePath: 'trace.zip' });
Problèmes audio
- Assurez-vous que les chemins des fichiers audio sont corrects par rapport à l'endroit où le script est exécuté.
- Si vous utilisez
mode: 'dom'et que vous comptez sur l'audio implicite (par ex. balises<audio>), assurez-vous que les éléments sont présents dans le DOM.