Quand utiliser
Utilisez cette skill à chaque fois que vous travaillez avec du code Remotion pour obtenir les connaissances spécifiques au domaine.
Configuration d'un nouveau projet
Lorsque vous êtes dans un dossier ou un espace de travail vide, sans projet Remotion existant, créez-en un à l'aide de la commande :
npx create-video@latest --yes --blank --no-tailwind my-video
Remplacez my-video par un nom de projet approprié.
Concevoir une vidéo
Avant de concevoir des scènes visuelles, des mises en page, des promos, des graphiques animés ou des vidéos à forte composante textuelle, chargez rules/video-layout.md pour obtenir des conseils sur la mise en page orientée vidéo et le dimensionnement du texte.
Animez les propriétés en utilisant useCurrentFrame() et interpolate(). Préférez interpolate() à spring(), sauf si un mouvement basé sur la physique est explicitement nécessaire. Utilisez Easing.bezier() pour personnaliser le timing, y compris les mouvements saccadés ou avec dépassement.
Pour les animations qui doivent être modifiables dans Remotion Studio, conservez l'appel interpolate() en ligne dans la propriété style et utilisez les propriétés CSS de transformation individuelles (scale, translate, rotate) plutôt que de composer une chaîne transform.
import { useCurrentFrame, Easing, interpolate, useVideoConfig } 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>;
};
Préférez :
style={{
scale: interpolate(frame, [0, 100], [0, 1]),
translate: interpolate(frame, [0, 100], ["0px 0px", "100px 100px"]),
rotate: interpolate(frame, [0, 100], ["20deg", "90deg"]),
}}
Plutôt que :
const scale = interpolate(frame, [0, 100], [0, 1]);
style={{
transform: `scale(${scale})`,
}}
Les transitions ou animations CSS sont INTERDITES – elles ne seront pas rendues correctement. Les noms de classes d'animation Tailwind sont INTERDITS – ils ne seront pas rendus correctement.
Placez les ressources dans le dossier public/ à la racine de votre projet.
Utilisez staticFile() pour référencer des fichiers depuis le dossier public/.
Ajoutez des images avec le composant <Img> :
import { Img, staticFile } from "remotion";
export const MyComposition = () => {
return <Img src={staticFile("logo.png")} style={{ width: 100, height: 100 }} />;
};
Ajoutez des vidéos avec le composant <Video> de @remotion/media :
import { Video } from "@remotion/media";
import { staticFile } from "remotion";
export const MyComposition = () => {
return <Video src={staticFile("video.mp4")} style={{ opacity: 0.5 }} />;
};
Ajoutez de l'audio avec le composant <Audio> de @remotion/media :
import { Audio } from "@remotion/media";
import { staticFile } from "remotion";
export const MyComposition = () => {
return <Audio src={staticFile("audio.mp3")} />;
};
Les ressources peuvent également être référencées via des URL distantes :
import { Video } from "@remotion/media";
export const MyComposition = () => {
return <Video src="https://remotion.media/video.mp4" />
};
Pour diffuser du contenu, enveloppez-le dans <Sequence> et utilisez from.
Pour limiter la durée d'un élément, utilisez durationInFrames de <Sequence>.
Par défaut, <Sequence> occupe tout l'espace. Pour du contenu en ligne, utilisez 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>
);
}
La largeur, la hauteur, le fps et la durée d'une vidéo sont définis dans src/Root.tsx :
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}
/>
);
};
Les métadonnées peuvent également être calculées dynamiquement :
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}
/>
);
};
Démarrer la prévisualisation
Lancez Remotion Studio pour prévisualiser une vidéo :
npx remotion studio
Facultatif : vérification d'un seul frame
Vous pouvez effectuer le rendu d'une seule image avec la CLI pour vérifier la mise en page, les couleurs ou le timing. Ignorez cette étape pour les modifications triviales, les refontes pures, ou lorsque vous avez déjà suffisamment confiance depuis Studio ou des rendus précédents.
npx remotion still [composition-id] --scale=0.25 --frame=30
À 30 fps, --frame=30 correspond à la marque d'une seconde (--frame est basé sur zéro).
Sous-titres
Lorsque vous traitez des sous-titres ou des légendes, chargez le fichier ./rules/subtitles.md pour plus d'informations.
Utilisation de FFmpeg
Pour certaines opérations vidéo, comme le rognage de vidéos ou la détection de silence, FFmpeg doit être utilisé. Chargez le fichier ./rules/ffmpeg.md pour plus d'informations.
Détection de silence
Lorsque vous devez détecter et rogner les segments silencieux de fichiers vidéo ou audio, chargez le fichier ./rules/silence-detection.md.
Visualisation audio
Lorsque vous devez visualiser l'audio (barres de spectre, formes d'onde, effets réactifs aux basses), chargez le fichier ./rules/audio-visualization.md pour plus d'informations.
Effets sonores
Lorsque vous devez utiliser des effets sonores, chargez le fichier ./rules/sfx.md pour plus d'informations.
Effets visuels et pixel
Lorsque vous créez un effet visuel, privilégiez : 1. une animation normale Remotion/HTML/CSS/SVG/filtre/mélange/masque, 2. un effet listé via rules/effects.md, y compris sur du HTML rendu via <HtmlInCanvas>, 3. un createEffect() personnalisé via rules/effects.md lorsque l'utilisateur demande un effet réutilisable/propre au projet, 4. un <HtmlInCanvas onPaint> personnalisé via rules/html-in-canvas.md uniquement si aucun effet ne convient.
Pour les surimpressions de fuites de lumière, consultez rules/light-leaks.md. Documentation : https://www.remotion.dev/docs/effects
Effets disponibles : brightness(), contrast(), colorKey(), duotone(), grayscale(), hue(), invert(), saturation(), tint(), thermalVision(), blur(), linearProgressiveBlur(), zoomBlur(), dropShadow(), glow(), lightTrail(), evolve(), mirror(), scale(), uvTranslate(), xyTranslate(), barrelDistortion(), chromaticAberration(), fisheye(), cornerPin(), wave(), burlap(), emboss(), dotGrid(), halftone(), noise(), noiseDisplacement(), pattern(), pixelate(), pixelDissolve(), scanlines(), speckle(), shine(), shrinkwrap(), vignette(), contourLines(), checkerboard(), halftoneLinearGradient(), gridlines(), whiteNoise(), tvSignalOff(), lines(), rings(), waves(), zigzag(), lightLeak(), starburst().
Contenu 3D
Consultez rules/3d.md pour le contenu 3D dans Remotion utilisant Three.js et React Three Fiber.
Audio avancé
Consultez rules/audio.md pour les fonctionnalités audio avancées comme le rognage, le volume, la vitesse, la hauteur.
Durée, dimensions et données dynamiques
Consultez rules/calculate-metadata.md pour définir dynamiquement la durée, les dimensions et les props d'une composition.
Compositions avancées
Consultez rules/compositions.md pour savoir comment définir des images fixes, des dossiers, des props par défaut et comment imbriquer des compositions.
Polices Google
C'est la méthode recommandée pour charger des polices dans Remotion. Consultez rules/google-fonts.md pour savoir comment charger les polices Google.
Polices locales
Consultez rules/local-fonts.md pour savoir comment charger des polices locales.
Obtenir la durée audio
Consultez rules/get-audio-duration.md pour obtenir la durée d'un fichier audio en secondes avec Mediabunny.
Obtenir les dimensions d'une vidéo
Consultez rules/get-video-dimensions.md pour obtenir la largeur et la hauteur d'un fichier vidéo avec Mediabunny.
Obtenir la durée d'une vidéo
Consultez rules/get-video-duration.md pour obtenir la durée d'un fichier vidéo en secondes avec Mediabunny.
GIFs
Consultez rules/gifs.md pour savoir comment afficher des GIFs synchronisés avec la timeline de Remotion.
Images avancées
Consultez rules/images.md pour le dimensionnement et le positionnement des images, les chemins d'images dynamiques et l'obtention des dimensions des images.
Animations Lottie
Consultez rules/lottie.md pour intégrer des animations Lottie dans Remotion.
Mesurer les nœuds DOM
Consultez rules/measuring-dom-nodes.md pour mesurer les dimensions des éléments DOM dans Remotion.
Mesurer le texte
Consultez rules/measuring-text.md pour mesurer les dimensions du texte, adapter le texte à des conteneurs et vérifier les débordements.
Séquencement avancé
Consultez rules/sequencing.md pour plus de motifs de séquencement - délai, rognage, limitation de durée des éléments.
TailwindCSS
Consultez rules/tailwind.md pour utiliser TailwindCSS dans Remotion.
Animations de texte
Consultez rules/text-animations.md pour les motifs de typographie et d'animation de texte.
Timing avancé
Consultez rules/timing.md pour le timing avancé avec interpolate et l'assouplissement Bézier, et les ressorts.
Transitions
Consultez rules/transitions.md pour les motifs de transition de scène.
Vidéos transparentes
Consultez rules/transparent-videos.md pour effectuer le rendu d'une vidéo avec transparence.
Rognage
Consultez rules/trimming.md pour les motifs de rognage - couper le début ou la fin des animations.
Vidéos avancées
Consultez rules/videos.md pour des connaissances avancées sur l'intégration de vidéos - rognage, volume, vitesse, boucle, hauteur.
Vidéos paramétrées
Consultez rules/parameters.md pour rendre une composition paramétrable en ajoutant un schéma Zod.
Cartes
Pour les cartes simples avec peu de survols, envisagez d'utiliser des images de carte statiques. Pour les cartes complexes avec des itinéraires animés ou des survols, chargez la règle des cartes : rules/maplibre.md
Voix off
Consultez rules/voiceover.md pour ajouter une voix off générée par IA aux compositions Remotion à l'aide de la synthèse vocale ElevenLabs.