Was macht Remotion-Steuerungs-Skill?
Ein professioneller Skill zur codegesteuerten Videoanimation mit Remotion. Remotion ist ein auf React basierendes Videoerstellungs-Framework, das es ermöglicht, jedes Bild präzise mit Code zu steuern und nativ transparente Hintergründe zu rendern.
Kernfähigkeiten
| Fähigkeit | Beschreibung |
|---|---|
| Transparenter Hintergrund | Native Alpha-Kanal-Unterstützung, Ausgabe von WebM (VP9) / MOV (ProRes 4444) mit transparentem Video |
| Codegenaue Steuerung | Präzise Steuerung von Position, Skalierung, Rotation, Transparenz und Easing-Kurven mit React/TypeScript |
| API-Service | HTTP-API zum Empfangen von Animationsbefehlen und Ausgeben von Videodateien |
| Vorlagenbibliothek | Voreingestellte Animationsvorlagen (Charakter-, UI-, Textanimationen, Übergangseffekte) |
| Qualitätskontrolle | Automatische Prüfung von Bildrate, Auflösung, Bitrate und Alpha-Kanal-Integrität |
| Selbstlernend | Erfassung von Rendering-Parametern und Bewertungen zur Optimierung von Voreinstellungen |
Abgrenzung zu ComfyUI / Blender
| Skill | Kernvorteil | Anwendungsszenarien |
|---|---|---|
| ComfyUI-Steuerung | KI-Generierung (Bild/Video/Audio), kreativ aber unkontrollierbar | Generierung von Charakteren, Szenen, Effektvideos |
| Blender-Steuerung | 3D-Animation, Physiksimulation, hochwertiges Rendering | 3D-Charakteranimation, Produktpräsentationen, physikalische Effekte |
| Remotion-Steuerung | 2D-Code-Animation, präzise steuerbar, transparenter Hintergrund | Vorlagenmaterial, UI-Animationen, Textlayouts, 2D-Charakteranimation |
Schnellstart
1. Abhängigkeiten installieren
cd remotion-project
npm install
2. Video mit transparentem Hintergrund rendern
# CLI-Methode
npx remotion render src/index.ts MeineKomposition out/video.webm --transparent
# API-Methode
python remotion_controls.py render --composition MeineKomposition --output out/video.webm --transparent
3. API-Dienst starten
python remotion_controls.py serve --port 8765
Hinweise zum Rendern mit transparentem Hintergrund (Verifizierter Prozess)
Remotion unterstützt nativ transparente Hintergründe, aber die --transparent-Kodierung über die CLI führt zum Verlust des Alpha-Kanals (für WebM VP8/VP9 und MOV ProRes verifiziert).
Korrigierter Prozess (PIT-024):
- PNG-Sequenz rendern:
npx remotion render src/index.ts Komposition out/frames --sequence(Ausgabe von PNG mit Alpha-Kanal) - ffmpeg-komprimieren zu ProRes 4444:
ffmpeg -y -framerate 30 -i out/frames/%04d.png \ -c:v prores_ks -profile:v 4 -pix_fmt yuva444p12le \ out/animation.mov - Alpha-Kanal prüfen:
python verify_animation.py out/animation.mov
Wichtig für die CapCut-Integration (PIT-024):
add_media_safeimportiert ProRes 4444 mov und führt zum Verlust des Alpha-Kanals (durch Transkodierung in H.264 mp4, was 66 MB auf 0,07 MB reduziert)- Manueller Import erforderlich: Kopiere das mov direkt in das materials-Verzeichnis des Projekts → Erstelle ein VideoMaterial → Registriere es in materials.videos → Erstelle ein VideoSegment(material=anim_material) → Führe add_segment aus
Qualitätsstandard für Animationsmaterial
Vollständiger Standard in QUALITY_STANDARD.md.
Harte Kriterien für qualitativ hochwertiges Animationsmaterial:
- Alpha-Kanal erhalten (yuva444p12le)
- ProRes 4444 Kodierung (profile=4)
- Auflösung, Bildrate und Dauer gemäß Konfiguration
- Inhaltsabdeckung ≥ 50% (10-Punkt-Abtastung)
- Angemessene Dateigröße (≤ 15 MB/s)
Automatisierte Prüfung:
python verify_animation.py <Animationsdatei> --duration 20 --width 1080 --height 1920
Komponentenbibliothek für Basis-Animationen
Befindet sich in remotion-project/src/components/, alle Komponenten unterstützen transparenten Hintergrund.
Charakter- und Bewegungskomponenten
| Komponente | Beschreibung |
|---|---|
| CharacterSprite | Charakter-Sprites: Multi-Posen-Wechsel, Keyframe-Animation für Position/Skalierung/Rotation/Transparenz |
| MotionPath | Bewegungspfade: Lineare/Bezier/Elastische/Springende Bewegung |
| FlashEffect | Weissblitz-Effekt: Schnelles Einblenden, langsames Ausblenden |
| ShakeEffect | Wackeleffekt: Zufälliges Wackeln mit abnehmender Amplitude |
| FadeEffect | Ein-/Ausblenden: Steuerbare Dauer für Ein- und Ausblenden |
| PopEffect | Pop-Up-Effekt: Elastisch skalierendes Einblenden |
| SlideEffect | Schiebe-Effekt: Gleitendes Ein-/Ausblenden aus vier Richtungen |
Textanimations-Komponenten (TextAnimations.tsx)
| Komponente | Beschreibung | Anwendungsszenarien |
|---|---|---|
| TextReveal | Zeichenweise Einblendung: Schreibmaschine/Einblenden/Hochschieben/Linksschieben | Erzählstimme, Dialoge, Titel-Intro |
| TextPop | Poppende Schrift: Skalierung/Rotation/Springen | Betonung von Schlüsselwörtern, Beat |
| TextWave | Wellenschrift: Zeichenweise sinusförmiges Schweben | Stilistischer Spaß, Hintergrundmusik-Rhythmus |
| TextGlitch | Glitch-Stil: RGB-Trennung + Zittern | Technologie-Look, Glitch-Art, Übergänge |
| TextGradient | Verlauf mit fließendem Licht: Farbverlauf + Scheinwerfer | Titel, Markennamen, hochwertiger Look |
| KineticText | Dynamisches Layout: Mehrzeilige kombinierte Animation | Eröffnungstitel, Abspann |
Übergangseffekte (TransitionEffects.tsx)
| Komponente | Beschreibung | Anwendungsszenarien |
|---|---|---|
| FadeTransition | Ein-/Ausblendübergang (in/out/inOut) | Allgemeine Übergänge, emotionale Übergänge |
| SlideTransition | Schiebeübergang (oben/unten/links/rechts) | Szenenwechsel, Inhaltswechsel |
| ZoomTransition | Zoomübergang (Heranzoomen/Wegzoomen) | Betonung von Punkten, Kamera-Heranfahrt |
| WipeTransition | Wischübergang (oben/unten/links/rechts/diagonal) | Kreative Übergänge, Stilisierung |
| BlurTransition | Unschärfeübergang (zuerst unscharf, dann scharf) | Traumhafte Übergänge, Rückblenden |
| GlitchTransition | Glitch-Übergang (RGB-Trennung + Scanlinien) | Technologie-Look, Glitch-Art |
Impact-Effekte (ImpactEffects.tsx)
| Komponente | Beschreibung | Anwendungsszenarien |
|---|---|---|
| PunchImpact | Schlag-Impact (Schockwelle + Sterne + Weissblitz) | Kampf, Schlag, Kollision |
| ImpactFlash | Impact-Blitz (schneller Weissblitz) | Harte Schläge, Explosionen, Beat |
| ParticleBurst | Partikelexplosion (Sterne/Funken/Splitter) | Feiern, Explosionen, Impact |
| Shockwave | Schockwelle (mehrere sich ausbreitende Ringe) | Energieentladung, Explosion, Erschütterung |
| SpeedLines | Geschwindigkeitslinien (radial) | Hochgeschwindigkeits-Impact, Sprint, Combo |
Anwendungsbeispiel:
import { PunchImpact, ParticleBurst, FadeTransition } from "./components";
// Kampfszene
<PunchImpact startFrame={90} x={540} y={800} scale={1.2} />
<ParticleBurst startFrame={90} x={540} y={800} count={16} particleType="star" />
<FadeTransition direction="in" duration={15} startFrame={0} color="#1a1a2e" />
Anwendungsbeispiel:
import { CharacterSprite, FlashEffect, TextReveal, TextPop } from "./components";
<CharacterSprite
poses={[
{ name: "idle", image: "/doubao_normal.png", frameRange: [0, 90],
position: [{frame: 0, x: 0, y: 0}, {frame: 90, x: 100, y: 0}] },
{ name: "falling", image: "/doubao_falling.png", frameRange: [90, 150] },
]}
width={250} height={250}
/>
<FlashEffect startFrame={90} duration={10} />
<TextReveal text="Wurde getroffen!" fontSize={56} startFrame={95} revealType="typewriter" />
<TextPop text="Autsch!" fontSize={72} color="#ff6b6b" startFrame={110} popType="bounce" />
Projektstruktur
remotion-controls-skill/
├── SKILL.md # Diese Datei
├── QUALITY_STANDARD.md # Qualitätsstandard für Animationsmaterial
├── verify_animation.py # Automatisiertes Prüfwerkzeug
├── remotion_controls.py # Hauptsteuerungsskript (CLI/API)
├── .env.example # Beispiel-Umgebungsvariablen
├── .gitignore
├── capabilities/
│ ├── cap_api_wrapper/ # Remotion API-Wrapper
│ ├── cap_animation_renderer/ # Animations-Renderer
│ ├── cap_template_library/ # Animationsvorlagen-Bibliothek
│ ├── cap_quality_control/ # Qualitätskontrolle
│ └── cap_self_evolution/ # Selbstlernende Evolution
├── remotion-project/ # Remotion Projekt
│ ├── src/
│ │ ├── components/ # Basis-Animation-Komponentenbibliothek
│ │ │ ├── CharacterSprite.tsx
│ │ │ ├── MotionPath.tsx
│ │ │ ├── Effects.tsx
│ │ │ └── index.ts
│ │ ├── AnimationTemplate.tsx # JSON-gesteuerte Animationsvorlage
│ │ ├── Root.tsx
│ │ └── index.ts
│ ├── public/ # Statische Materialien (Charakter-/Prop-Bilder)
│ └── package.json
└── out/ # Rendering-Ausgabe
Fähigkeitsmodule
cap_api_wrapper — Remotion API-Wrapper
render_media(): Video rendern (Unterstützung für transparenten Hintergrund)render_still(): Einzelnes Standbild rendernselect_composition(): Verfügbare Composition-Liste abrufenget_props_schema(): Props-Definition für eine Composition abrufen
cap_animation_renderer — Animations-Renderer
- Eingabe von Animationsbefehlen (JSON) → Ausgabe von Video mit transparentem Hintergrund
- Unterstützt Keyframe-Animation (Position/Skalierung/Rotation/Transparenz)
- Unterstützt Easing-Kurven (ease-in/ease-out/ease-in-out/linear/spring)
- Unterstützt Mehrschicht-Komposition
cap_template_library — Animationsvorlagen-Bibliothek
- Charakter-Animation-Vorlagen (Doubao wird getroffen, Emotionswechsel usw.)
- UI-Animation-Vorlagen (Button-Klick, Seitenwechsel usw.)
- Text-Animation-Vorlagen (Schreibmaschine, Ein-/Ausblenden, Springen usw.)
- Übergangs-Vorlagen (Ein-/Ausblenden, Schieben, Zoomen usw.)
cap_quality_control — Qualitätskontrolle
- Bildratenprüfung (24/30/60 fps)
- Auflösungsprüfung (1080p/4K)
- Alpha-Kanal-Integritätsprüfung
- Vergleich der Videodauer mit Erwartung
- Prüfung auf angemessene Dateigröße
cap_self_evolution — Selbstlernende Evolution
- Aufzeichnung von Rendering-Parametern und Bewertungen
- Optimierung von Voreinstellungen
- Generierung von Best-Practice-Dokumenten
- Bestenliste für Vorlageneffekte
Umgebungsvariablen
REMOTION_PROJECT_PATH=./remotion-project
REMOTION_OUTPUT_DIR=./output
REMOTION_DEFAULT_FPS=30
REMOTION_DEFAULT_WIDTH=1080
REMOTION_DEFAULT_HEIGHT=1920
REMOTION_API_PORT=8765
Integration mit ai-video-editor
Der Remotion-Steuerungs-Skill dient als Animationsmaterial-Erstellungswerkzeug für den ai-video-editor:
- Die Direktoren-Engine des ai-video-editors gibt Animationsbefehle aus
- Der Remotion-Steuerungs-Skill empfängt die Befehle und rendert Videos mit transparentem Hintergrund
- Die Videos mit transparentem Hintergrund werden als Animationsmaterialschicht für CapCut-Vorlagen verwendet
- Nach dem Ersetzen des Hintergrunds durch den Benutzer überlagert sich die Animation perfekt
Hinweise
- Remotion erfordert Node.js 18+ Umgebung
- Für transparente Hintergrundvideos wird das WebM-Format empfohlen (gute CapCut-Kompatibilität)
- Das Rendern langer Videos ist zeitaufwändig; es wird empfohlen, in Segmenten zu rendern und dann zu kombinieren
- Vermeiden Sie CSS-Filter in Animationen (einige Filter unterstützen keine transparenten Hintergründe)