Wann verwenden
Verwenden Sie dieses Skill immer dann, wenn Sie mit Remotion-Code arbeiten, um das domänenspezifische Wissen zu erhalten.
Neues Projekt einrichten
Wenn Sie sich in einem leeren Ordner oder Workspace ohne bestehendes 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 passenden 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-Transitionen oder -Animationen sind VERBOTEN – sie werden nicht korrekt rendern. Tailwind-Animation-Klassennamen sind VERBOTEN – sie werden nicht korrekt rendern.
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 zeitlich zu verschieben, umschließen Sie sie mit <Sequence> und verwenden Sie from.
Um die Dauer eines Elements zu begrenzen, verwenden Sie durationInFrames von <Sequence>.
<Sequence> ist standardmäßig ein absolutes Füllelement. 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>
);
}
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 zu sehen:
npx remotion studio
Optional: Einzelbild-Renderprüfung
Sie können mit der CLI ein einzelnes Bild rendern, um Layout, Farben oder Timing zu überprüfen. Überspringen Sie dies bei trivialen Änderungen, reinen Refactorings oder wenn Sie bereits ausreichend Vertrauen aus dem Studio oder früheren 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 oder Bildschirmtexten arbeiten, laden Sie die Datei ./rules/subtitles.md für weitere Informationen.
FFmpeg verwenden
Für bestimmte Videooperationen wie das Trimmen von Videos oder die Stille-Erkennung sollte FFmpeg verwendet werden. Laden Sie die Datei ./rules/ffmpeg.md für weitere Informationen.
Stille-Erkennung
Wenn stille Segmente in Video- oder Audiodateien erkannt und getrimmt werden müssen, laden Sie die Datei ./rules/silence-detection.md.
Audio-Visualisierung
Wenn Audio visualisiert werden soll (Spektrumbalken, Wellenformen, bassreaktive Effekte), laden Sie die Datei ./rules/audio-visualization.md für weitere Informationen.
Soundeffekte
Wenn Soundeffekte verwendet werden sollen, 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 und Tonhöhe.
Dynamische Dauer, Abmessungen und Daten
Siehe rules/calculate-metadata.md für dynamisch gesetzte 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 der empfohlene Weg, um Schriftarten in Remotion zu laden. 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 für die Ermittlung der Dauer einer Audiodatei in Sekunden mit Mediabunny.
Videoabmessungen ermitteln
Siehe rules/get-video-dimensions.md für die Ermittlung der Breite und Höhe einer Videodatei mit Mediabunny.
Videodauer ermitteln
Siehe rules/get-video-duration.md für die Ermittlung der Dauer einer Videodatei in Sekunden mit Mediabunny.
GIFs
Siehe rules/gifs.md für die Darstellung von GIFs synchronisiert mit der Remotion-Zeitleiste.
Erweiterte Bilder
Siehe rules/images.md für die Größenanpassung und Positionierung von Bildern, dynamische Bildpfade und das Ermitteln von Bildabmessungen.
Lichtlecks
Siehe rules/light-leaks.md für Lichtleck-Überlagerungseffekte mit @remotion/light-leaks.
Lottie-Animationen
Siehe rules/lottie.md für das Einbetten von Lottie-Animationen in Remotion.
HTML im 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 für das Messen von DOM-Elementabmessungen in Remotion.
Text messen
Siehe rules/measuring-text.md für das Messen von Textabmessungen, das Anpassen von Text an Container und die Überlaufprüfung.
Erweiterte Sequenzierung
Siehe rules/sequencing.md für weitere Sequenzierungsmuster – Verzögerung, Trimmen, Begrenzung der Dauer von Elementen.
TailwindCSS
Siehe rules/tailwind.md für die 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 Bezier-Easing sowie Federn.
Übergänge
Siehe rules/transitions.md für Szenenübergangsmuster.
Transparente Videos
Siehe rules/transparent-videos.md für das Rendern eines Videos mit Transparenz.
Trimmen
Siehe rules/trimming.md für Trimm-Muster – das Abschneiden des Anfangs oder Endes von Animationen.
Erweiterte Videos
Siehe rules/videos.md für erweiterte Kenntnisse zum Einbetten von Videos – Trimmen, Lautstärke, Geschwindigkeit, Schleifen, Tonhöhe.
Parametrisierte Videos
Siehe rules/parameters.md für die Parametrisierung einer Komposition durch Hinzufügen eines Zod-Schemas.
Karten
Für einfache Karten mit wenigen Überflügen sollten Sie statische Kartenbilder in Betracht ziehen. Für komplexe Karten mit animierten Routen oder Überflügen laden Sie die Kartenregel: rules/maplibre.md
Sprachausgabe
Siehe rules/voiceover.md für das Hinzufügen von KI-generierter Sprachausgabe zu Remotion-Kompositionen mit ElevenLabs TTS.