Compétences de Génération Vidéo Remotion
App Factory inclut un pipeline vidéo Remotion intégré pour générer des vidéos de démonstration des applications construites.
Quand cette compétence s'applique
- Travailler avec des fichiers dans le répertoire
demo-video/ - Exécuter la commande
/factory video - Créer ou modifier des compositions Remotion
- Déboguer des problèmes de rendu vidéo
- Comprendre les animations basées sur les trames
Structure du projet
demo-video/
├── src/
│ ├── index.ts # Point d'entrée Remotion
│ ├── Root.tsx # Registre des compositions
│ ├── compositions/
│ │ └── AppFactoryDemo.tsx # Vidéo de démo principale (10s, 1920x1080)
│ └── components/
│ ├── Title.tsx # Titre animé
│ ├── BulletPoints.tsx # Points saillants décalés
│ ├── VerificationBadge.tsx # Badge PASS
│ └── Footer.tsx # Horodatage UTC
├── remotion.config.ts # Configuration Remotion
└── package.json # Dépendances (Remotion v4.x)
Règles critiques (À SUIVRE ABSOLUMENT)
1. Animations basées sur les trames UNIQUEMENT
// CORRECT : Utiliser useCurrentFrame() pour toutes les animations
const frame = useCurrentFrame();
const opacity = interpolate(frame, [0, 30], [0, 1], {
extrapolateRight: 'clamp',
});
// INTERDIT : Animations/transitions CSS
// Ne jamais utiliser : animation:, transition:, @keyframes
2. Interpolation avec extrapolation limitée
// TOUJOURS utiliser l'extrapolation limitée
const value = interpolate(frame, [0, 60], [0, 100], {
extrapolateLeft: 'clamp',
extrapolateRight: 'clamp',
});
3. Animations Spring
// Utiliser spring() pour les animations basées sur la physique
const springValue = spring({
fps,
frame,
config: { damping: 200, stiffness: 100 },
durationInFrames: 40,
});
4. Exigences de déterminisme
- Les horodatages DOIVENT être des accessoires d'entrée, jamais
new Date() - Utiliser
timeZone: 'UTC'pour tout formatage de date - Pas de
Math.random()ni de valeurs non déterministes - Les mêmes accessoires doivent produire une sortie vidéo identique
5. Structure des composants
// Toutes les compositions doivent suivre ce modèle
export const MaComposition: React.FC<Props> = (props) => {
const frame = useCurrentFrame();
const { fps, width, height, durationInFrames } = useVideoConfig();
return (
<AbsoluteFill style={{ backgroundColor: '#000' }}>
{/* Contenu séquencé */}
<Sequence from={0} durationInFrames={60}>
<Scene1 />
</Sequence>
<Sequence from={60} durationInFrames={60}>
<Scene2 />
</Sequence>
</AbsoluteFill>
);
};
Intégration du pipeline
Flux de génération automatique
- La vérification de la preuve d'exécution locale s'exécute
RUN_CERTIFICATE.jsonest créé avecstatus: "PASS"- Le déclencheur exécute
post-run-certificate-video.mjs - La vidéo de démonstration est rendue dans
demo/out/<slug>.mp4
Rendu manuel
# Utilisation de base
node scripts/render-demo-video.mjs --cwd ./mon-app --slug mon-app
# Avec points saillants personnalisés
node scripts/render-demo-video.mjs \
--cwd ./mon-app \
--slug mon-app \
--title "Mon incroyable app" \
--highlights '["Fonctionnalité 1", "Fonctionnalité 2", "Fonctionnalité 3"]'
Schéma des accessoires
interface AppFactoryDemoProps {
title: string; // Nom de l'application
slug: string; // Identifiant compatible URL
verifiedUrl: string; // URL localhost ayant passé la vérification
timestamp: string; // Horodatage ISO 8601 (UTC)
highlights: string[]; // 4-6 points clés
certificateHash: string; // SHA256 de RUN_CERTIFICATE.json
}
Débogage
# Aperçu dans Remotion Studio
cd demo-video && npm run studio
# Rendu d'une composition spécifique
npx remotion render src/index.ts AppFactoryDemo output.mp4
# Vérifier la présence d'erreurs TypeScript
npx tsc --noEmit
Modèles courants
Apparition/Disparition en fondu
const fadeIn = interpolate(frame, [0, 30], [0, 1], {
extrapolateRight: 'clamp',
});
const fadeOut = interpolate(frame, [duration - 30, duration], [1, 0], {
extrapolateLeft: 'clamp',
extrapolateRight: 'clamp',
});
const opacity = fadeIn * fadeOut;
Animation décalée
items.map((item, index) => {
const delay = index * 10; // 10 trames entre chaque
const itemOpacity = interpolate(
frame,
[delay, delay + 20],
[0, 1],
{ extrapolateLeft: 'clamp', extrapolateRight: 'clamp' }
);
return <Item key={index} style={{ opacity: itemOpacity }} />;
});
Mise à l'échelle avec Spring
const scaleSpring = spring({
fps,
frame: frame - startFrame,
config: { damping: 80, stiffness: 200 },
});
const scale = interpolate(scaleSpring, [0, 1], [0.8, 1]);
Codes d'erreur
| Code | Signification | Résolution |
|---|---|---|
| FAC-006 | Échec du rendu vidéo | Vérifier les logs Remotion, confirmer ffmpeg installé |
| FAC-007 | Certificat manquant | Exécuter d'abord la preuve d'exécution locale |
| FAC-008 | Échec de validation des accessoires | Vérifier que les types correspondent au schéma |