Habilidades de Generación de Video Remotion
App Factory incluye un pipeline integrado de video Remotion para generar videos demo de las aplicaciones construidas.
Cuándo se Aplica Esta Habilidad
- Trabajar con archivos en el directorio
demo-video/ - Ejecutar el comando
/factory video - Crear o modificar composiciones Remotion
- Depurar problemas de renderizado de video
- Comprender animaciones basadas en cuadros
Estructura del Proyecto
demo-video/
├── src/
│ ├── index.ts # Punto de entrada de Remotion
│ ├── Root.tsx # Registro de composiciones
│ ├── compositions/
│ │ └── AppFactoryDemo.tsx # Video demo principal (10s, 1920x1080)
│ └── components/
│ ├── Title.tsx # Título animado
│ ├── BulletPoints.tsx # Destacados escalonados
│ ├── VerificationBadge.tsx # Insignia PASS
│ └── Footer.tsx # Marca de tiempo UTC
├── remotion.config.ts # Configuración de Remotion
└── package.json # Dependencias (Remotion v4.x)
Reglas Críticas (DEBEN SEGUIRSE)
1. Solo Animaciones Basadas en Cuadros
// CORRECTO: Usa useCurrentFrame() para todas las animaciones
const frame = useCurrentFrame();
const opacity = interpolate(frame, [0, 30], [0, 1], {
extrapolateRight: 'clamp',
});
// PROHIBIDO: Animaciones/transiciones CSS
// Nunca usar: animation:, transition:, @keyframes
2. Interpolar con Sujeción
// SIEMPRE usar sujeción de extrapolación
const value = interpolate(frame, [0, 60], [0, 100], {
extrapolateLeft: 'clamp',
extrapolateRight: 'clamp',
});
3. Animaciones con Resorte
// Usa spring() para animaciones basadas en física
const springValue = spring({
fps,
frame,
config: { damping: 200, stiffness: 100 },
durationInFrames: 40,
});
4. Requisitos de Determinismo
- Las marcas de tiempo DEBEN ser props de entrada, nunca
new Date() - Usar
timeZone: 'UTC'para todo formato de fecha - Sin
Math.random()ni valores no deterministas - Las mismas props deben producir una salida de video idéntica
5. Estructura de Componentes
// Todas las composiciones deben seguir este patrón
export const MyComposition: React.FC<Props> = (props) => {
const frame = useCurrentFrame();
const { fps, width, height, durationInFrames } = useVideoConfig();
return (
<AbsoluteFill style={{ backgroundColor: '#000' }}>
{/* Contenido secuenciado */}
<Sequence from={0} durationInFrames={60}>
<Scene1 />
</Sequence>
<Sequence from={60} durationInFrames={60}>
<Scene2 />
</Sequence>
</AbsoluteFill>
);
};
Integración del Pipeline
Flujo de Generación Automática
- Se ejecuta la verificación de Local Run Proof
- Se crea
RUN_CERTIFICATE.jsonconstatus: "PASS" - El hook dispara
post-run-certificate-video.mjs - El video demo se renderiza en
demo/out/<slug>.mp4
Renderización Manual
# Uso básico
node scripts/render-demo-video.mjs --cwd ./my-app --slug my-app
# Con destacados personalizados
node scripts/render-demo-video.mjs \
--cwd ./my-app \
--slug my-app \
--title "Mi App Increíble" \
--highlights '["Característica 1", "Característica 2", "Característica 3"]'
Esquema de Props
interface AppFactoryDemoProps {
title: string; // Nombre de la app
slug: string; // Identificador seguro para URL
verifiedUrl: string; // URL localhost que pasó la verificación de salud
timestamp: string; // Marca de tiempo ISO 8601 (UTC)
highlights: string[]; // 4-6 puntos clave
certificateHash: string; // SHA256 de RUN_CERTIFICATE.json
}
Depuración
# Previsualización en Remotion Studio
cd demo-video && npm run studio
# Renderizar composición específica
npx remotion render src/index.ts AppFactoryDemo output.mp4
# Verificar errores de TypeScript
npx tsc --noEmit
Patrones Comunes
Fundido de Entrada/Salida
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;
Animación Escalonada
items.map((item, index) => {
const delay = index * 10; // 10 cuadros entre cada uno
const itemOpacity = interpolate(
frame,
[delay, delay + 20],
[0, 1],
{ extrapolateLeft: 'clamp', extrapolateRight: 'clamp' }
);
return <Item key={index} style={{ opacity: itemOpacity }} />;
});
Escala con Resorte
const scaleSpring = spring({
fps,
frame: frame - startFrame,
config: { damping: 80, stiffness: 200 },
});
const scale = interpolate(scaleSpring, [0, 1], [0.8, 1]);
Códigos de Error
| Código | Significado | Resolución |
|---|---|---|
| FAC-006 | Falló el renderizado de video | Revisar logs de Remotion, verificar ffmpeg instalado |
| FAC-007 | Certificado faltante | Ejecutar Local Run Proof primero |
| FAC-008 | Validación de props falló | Verificar que los tipos de props coincidan con el esquema |