Remotion-Videogenerierung-Skills
App Factory beinhaltet eine integrierte Remotion-Videopipeline zur Erstellung von Demovideos für gebaute Anwendungen.
Wann dieser Skill angewendet wird
- Arbeiten mit Dateien im Verzeichnis
demo-video/ - Ausführen des Befehls
/factory video - Erstellen oder Ändern von Remotion-Kompositionen
- Debuggen von Videorendering-Problemen
- Verstehen von frame-basierten Animationen
Projektstruktur
demo-video/
├── src/
│ ├── index.ts # Remotion-Einstiegspunkt
│ ├── Root.tsx # Kompositionsregister
│ ├── compositions/
│ │ └── AppFactoryDemo.tsx # Haupt-Demovideo (10s, 1920x1080)
│ └── components/
│ ├── Title.tsx # Animierter Titel
│ ├── BulletPoints.tsx # Gestaffelte Highlights
│ ├── VerificationBadge.tsx # PASS-Abzeichen
│ └── Footer.tsx # UTC-Zeitstempel
├── remotion.config.ts # Remotion-Konfiguration
└── package.json # Abhängigkeiten (Remotion v4.x)
Kritische Regeln (MÜSSEN BEFOLGT WERDEN)
1. Nur Frame-basierte Animationen
// RICHTIG: useCurrentFrame() für alle Animationen verwenden
const frame = useCurrentFrame();
const opacity = interpolate(frame, [0, 30], [0, 1], {
extrapolateRight: 'clamp',
});
// VERBOTEN: CSS-Animationen/Transitions
// Niemals verwenden: animation:, transition:, @keyframes
2. Interpolieren mit Clamping
// IMMER extrapolation clamping verwenden
const value = interpolate(frame, [0, 60], [0, 100], {
extrapolateLeft: 'clamp',
extrapolateRight: 'clamp',
});
3. Spring-Animationen
// spring() für physikbasierte Animationen verwenden
const springValue = spring({
fps,
frame,
config: { damping: 200, stiffness: 100 },
durationInFrames: 40,
});
4. Deterministismus-Anforderungen
- Zeitstempel MÜSSEN als Eingabe-Props übergeben werden, niemals
new Date() - Für alle Datumsformatierungen
timeZone: 'UTC'verwenden - Kein
Math.random()oder nicht-deterministische Werte - Gleiche Props müssen identische Videoausgabe erzeugen
5. Komponentenstruktur
// Alle Kompositionen müssen diesem Muster folgen
export const MyComposition: React.FC<Props> = (props) => {
const frame = useCurrentFrame();
const { fps, width, height, durationInFrames } = useVideoConfig();
return (
<AbsoluteFill style={{ backgroundColor: '#000' }}>
{/* Sequenzierter Inhalt */}
<Sequence from={0} durationInFrames={60}>
<Scene1 />
</Sequence>
<Sequence from={60} durationInFrames={60}>
<Scene2 />
</Sequence>
</AbsoluteFill>
);
};
Pipeline-Integration
Automatischer Generierungsablauf
- Local Run Proof-Überprüfung läuft
RUN_CERTIFICATE.jsonwird mitstatus: "PASS"erstellt- Hook löst
post-run-certificate-video.mjsaus - Demovideo wird nach
demo/out/<slug>.mp4gerendert
Manuelles Rendern
# Einfache Nutzung
node scripts/render-demo-video.mjs --cwd ./meine-app --slug meine-app
# Mit benutzerdefinierten Highlights
node scripts/render-demo-video.mjs \
--cwd ./meine-app \
--slug meine-app \
--title "Meine fantastische App" \
--highlights '["Feature 1", "Feature 2", "Feature 3"]'
Props-Schema
interface AppFactoryDemoProps {
title: string; // App-Name
slug: string; // URL-sicherer Identifikator
verifiedUrl: string; // Localhost-URL, die den Health-Check bestanden hat
timestamp: string; // ISO 8601-Zeitstempel (UTC)
highlights: string[]; // 4-6 Aufzählungspunkte
certificateHash: string; // SHA256 von RUN_CERTIFICATE.json
}
Fehlerbehebung
# Vorschau im Remotion Studio
cd demo-video && npm run studio
# Bestimmte Komposition rendern
npx remotion render src/index.ts AppFactoryDemo output.mp4
# Auf TypeScript-Fehler prüfen
npx tsc --noEmit
Häufige Muster
Ein-/Ausblenden
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;
Gestaffelte Animation
items.map((item, index) => {
const delay = index * 10; // 10 Frames zwischen jedem
const itemOpacity = interpolate(
frame,
[delay, delay + 20],
[0, 1],
{ extrapolateLeft: 'clamp', extrapolateRight: 'clamp' }
);
return <Item key={index} style={{ opacity: itemOpacity }} />;
});
Skalieren mit Spring
const scaleSpring = spring({
fps,
frame: frame - startFrame,
config: { damping: 80, stiffness: 200 },
});
const scale = interpolate(scaleSpring, [0, 1], [0.8, 1]);
Fehlercodes
| Code | Bedeutung | Lösung |
|---|---|---|
| FAC-006 | Video-Rendering fehlgeschlagen | Remotion-Logs prüfen, ffmpeg-Installation überprüfen |
| FAC-007 | Zertifikat fehlt | Zuerst Local Run Proof ausführen |
| FAC-008 | Props-Validierung fehlgeschlagen | Prop-Typen mit Schema abgleichen |