Wann verwenden
Verwenden Sie diese Skills immer dann, wenn Sie mit Remotion-Code arbeiten, um domänenspezifisches Wissen zu erhalten.
Neues Projekt einrichten
Wenn Sie sich in einem leeren Ordner oder Workspace ohne vorhandenes Remotion-Projekt befinden, richten Sie eines mit folgendem Befehl ein:
npx create-video@latest --yes --blank --no-tailwind my-video
Ersetzen Sie my-video durch einen geeigneten Projektnamen.
Ein Video gestalten
Animieren Sie Eigenschaften mit useCurrentFrame() und interpolate(). Verwenden Sie Easing, um das Timing der Animation anzupassen.
import { useCurrentFrame, Easing } from "remotion";
export const FadeIn = () => {
const frame = useCurrentFrame();
const { fps } = useVideoConfig();
const opacity = interpolate(frame, [0, 2 * fps], [0, 1], {
extrapolateRight: "clamp",
extrapolateLeft: "clamp",
easing: Easing.bezier(0.16, 1, 0.3, 1),
});
return <div style={{ opacity }}>Hello World!</div>;
};
CSS-Übergänge oder -Animationen sind VERBOTEN – sie werden nicht korrekt gerendert. Tailwind-Animationsklassennamen sind VERBOTEN – sie werden nicht korrekt gerendert.
Legen Sie Assets im public/-Ordner im Projektstammverzeichnis ab.
Verwenden Sie staticFile(), um Dateien aus dem public/-Ordner zu referenzieren.
Fügen Sie Bilder mit der <Img>-Komponente hinzu:
import { Img, staticFile } from "remotion";
export const MyComposition = () => {
return <Img src={staticFile("logo.png")} style={{ width: 100, height: 100 }} />;
};
Fügen Sie Videos mit der <Video>-Komponente aus @remotion/media hinzu:
import { Video } from "@remotion/media";
import { staticFile } from "remotion";
export const MyComposition = () => {
return <Video src={staticFile("video.mp4")} style={{ opacity: 0.5 }} />;
};
Fügen Sie Audio mit der <Audio>-Komponente aus @remotion/media hinzu:
import { Audio } from "@remotion/media";
import { staticFile } from "remotion";
export const MyComposition = () => {
return <Audio src={staticFile("audio.mp3")} />;
};
Assets können auch als Remote-URLs referenziert werden:
import { Video } from "@remotion/media";
export const MyComposition = () => {
return <Video src="https://remotion.media/video.mp4" />
};
Um Inhalte zu verzögern, umschließen Sie sie mit <Sequence> und verwenden Sie from.
Um die Dauer eines Elements zu begrenzen, verwenden Sie durationInFrames von <Sequence>.
<Sequence> standardmäßig eine absolute Füllung. Für Inline-Inhalte verwenden Sie layout="none".
import { Sequence } from "remotion";
export const Title = () => {
const frame = useCurrentFrame();
const { fps } = useVideoConfig();
const opacity = interpolate(frame, [0, 2 * fps], [0, 1], {
extrapolateRight: "clamp",
extrapolateLeft: "clamp",
easing: Easing.bezier(0.16, 1, 0.3, 1),
});
return <div style={{ opacity }}>Title</div>;
};
export const Subtitle = () => {
return <div>Subtitle</div>;
};
const Main = () => {
const {fps} = useVideoConfig();
return (
<AbsoluteFill>
<Sequence>
<Background />
</Sequence>
<Sequence from={1 * fps} durationInFrames={2 * fps} layout="none">
<Title />
</Sequence>
<Sequence from={2 * fps} durationInFrames={2 * fps} layout="none">
<Subtitle />
</Sequence>
</AbsoluteFill>
);
}
Die Breite, Höhe, fps und Dauer eines Videos werden in src/Root.tsx definiert:
import { Composition } from "remotion";
import { MyComposition } from "./MyComposition";
export const RemotionRoot = () => {
return (
<Composition
id="MyComposition"
component={MyComposition}
durationInFrames={100}
fps={30}
width={1080}
height={1080}
/>
);
};
Metadaten können auch dynamisch berechnet werden:
import { Composition, CalculateMetadataFunction } from "remotion";
import { MyComposition, MyCompositionProps } from "./MyComposition";
const calculateMetadata: CalculateMetadataFunction<
MyCompositionProps
> = async ({ props, abortSignal }) => {
const data = await fetch(`https://api.example.com/video/${props.videoId}`, {
signal: abortSignal,
}).then((res) => res.json());
return {
durationInFrames: Math.ceil(data.duration * 30),
props: {
...props,
videoUrl: data.url,
},
width: 1080,
height: 1080,
};
};
export const RemotionRoot = () => {
return (
<Composition
id="MyComposition"
component={MyComposition}
fps={30}
width={1080}
height={1080}
defaultProps={{ videoId: "abc123" }}
calculateMetadata={calculateMetadata}
/>
);
};
Vorschau starten
Starten Sie das Remotion Studio, um eine Vorschau eines Videos anzuzeigen:
npx remotion studio
Optional: Einzelbild-Renderprüfung
Sie können ein einzelnes Bild mit der CLI rendern, um Layout, Farben oder Timing zu überprüfen. Überspringen Sie dies bei trivialen Änderungen, reinen Refactorings oder wenn Sie bereits genug Vertrauen aus dem Studio oder vorherigen Renderings haben.
npx remotion still [composition-id] --scale=0.25 --frame=30
Bei 30 fps ist --frame=30 die Ein-Sekunden-Marke (--frame ist nullbasiert).
Untertitel
Wenn Sie mit Untertiteln arbeiten, laden Sie die Datei ./rules/subtitles.md für weitere Informationen.
Verwendung von FFmpeg
Für einige Videooperationen, wie das Trimmen von Videos oder die Stilleerkennung, sollte FFmpeg verwendet werden. Laden Sie die Datei ./rules/ffmpeg.md für weitere Informationen.
Stilleerkennung
Wenn stille Segmente in Video- oder Audiodateien erkannt und entfernt werden müssen, laden Sie die Datei ./rules/silence-detection.md.
Audio-Visualisierung
Wenn Audio visualisiert werden muss (Spektrumbalken, Wellenformen, bassreaktive Effekte), laden Sie die Datei ./rules/audio-visualization.md für weitere Informationen.
Soundeffekte
Wenn Soundeffekte verwendet werden müssen, laden Sie die Datei ./rules/sfx.md für weitere Informationen.
3D-Inhalte
Siehe rules/3d.md für 3D-Inhalte in Remotion mit Three.js und React Three Fiber.
Erweitertes Audio
Siehe rules/audio.md für erweiterte Audiofunktionen wie Trimmen, Lautstärke, Geschwindigkeit, Tonhöhe.
Dynamische Dauer, Abmessungen und Daten
Siehe rules/calculate-metadata.md für dynamisch festgelegte Kompositionsdauer, -abmessungen und -eigenschaften.
Erweiterte Kompositionen
Siehe rules/compositions.md für die Definition von Standbildern, Ordnern, Standardeigenschaften und die Verschachtelung von Kompositionen.
Google Fonts
Ist die empfohlene Methode zum Laden von Schriftarten in Remotion. Siehe rules/google-fonts.md für das Laden von Google Fonts.
Lokale Schriftarten
Siehe rules/local-fonts.md für das Laden lokaler Schriftarten.
Audiodauer ermitteln
Siehe rules/get-audio-duration.md zum Ermitteln der Dauer einer Audiodatei in Sekunden mit Mediabunny.
Videoabmessungen ermitteln
Siehe rules/get-video-dimensions.md zum Ermitteln der Breite und Höhe einer Videodatei mit Mediabunny.
Videodauer ermitteln
Siehe rules/get-video-duration.md zum Ermitteln der Dauer einer Videodatei in Sekunden mit Mediabunny.
GIFs
Siehe rules/gifs.md zum Anzeigen von GIFs, die mit der Zeitachse von Remotion synchronisiert sind.
Erweiterte Bilder
Siehe rules/images.md zum Größenanpassen und Positionieren von Bildern, dynamischen Bildpfaden und zum Ermitteln von Bildabmessungen.
Light Leaks
Siehe rules/light-leaks.md für Light-Leak-Überlagerungseffekte mit @remotion/light-leaks.
Lottie-Animationen
Siehe rules/lottie.md zum Einbetten von Lottie-Animationen in Remotion.
HTML in Canvas
Siehe rules/html-in-canvas.md, wenn Sie HTML in ein <canvas> rendern müssen, um 2D- oder WebGL-Effekte über <HtmlInCanvas> anzuwenden.
DOM-Knoten messen
Siehe rules/measuring-dom-nodes.md zum Messen von DOM-Elementabmessungen in Remotion.
Text messen
Siehe rules/measuring-text.md zum Messen von Textabmessungen, Anpassen von Text an Container und Überprüfen von Überläufen.
Erweiterte Sequenzierung
Siehe rules/sequencing.md für weitere Sequenzierungsmuster – Verzögerung, Trimmen, Begrenzung der Dauer von Elementen.
TailwindCSS
Siehe rules/tailwind.md zur Verwendung von TailwindCSS in Remotion.
Textanimationen
Siehe rules/text-animations.md für Typografie- und Textanimationsmuster.
Erweitertes Timing
Siehe rules/timing.md für erweitertes Timing mit interpolate und Bézier-Easing sowie Federn.
Übergänge
Siehe rules/transitions.md für Szenenübergangsmuster.
Transparente Videos
Siehe rules/transparent-videos.md zum Rendern eines Videos mit Transparenz.
Trimmen
Siehe rules/trimming.md für Trimm-Muster – Abschneiden des Anfangs oder Endes von Animationen.
Erweiterte Videos
Siehe rules/videos.md für erweitertes Wissen zum Einbetten von Videos – Trimmen, Lautstärke, Geschwindigkeit, Schleifen, Tonhöhe.
Parametrisierte Videos
Siehe rules/parameters.md zum Parametrisieren einer Komposition durch Hinzufügen eines Zod-Schemas.
Karten
Für einfache Karten mit kurzen Überflügen sollten Sie statische Kartenbilder verwenden. Für komplexe Karten mit animierten Routen oder Überflügen laden Sie die Kartenregel: rules/maplibre.md
Voiceover
Siehe rules/voiceover.md zum Hinzufügen von KI-generiertem Voiceover zu Remotion-Kompositionen mit ElevenLabs TTS.