Ce guide fournit des bonnes pratiques pour écrire du code React Remotion. Si cela n'est pas pertinent, chargez plutôt Remotion Best Practices.
Règles générales
Animez les propriétés en utilisant useCurrentFrame() et interpolate().
Utilisez interpolate() de préférence à spring().
Utilisez Easing.bezier() pour personnaliser le timing, y compris les mouvements saccadés ou avec dépassement.
Utilisez Easing.spring() si vous voulez des animations à ressort.
Les éléments HTML qui ont un intérêt à être interactifs dans le Studio doivent utiliser Interactive : <div> -> <Interactive.Div>.
Définissez une propriété name descriptive telle que name="Titre Hero" pour Interactive, Solid, Sequence.
import { useCurrentFrame, Easing, interpolate, Interactive } from "remotion";
export const FadeIn = () => {
const frame = useCurrentFrame();
return (
<Interactive.Div
name="Titre"
style={{
opacity: interpolate(frame, [0, 60], [0, 1], {
extrapolateRight: "clamp",
extrapolateLeft: "clamp",
easing: Easing.bezier(0.16, 1, 0.3, 1),
}),
}}
>
Bonjour le monde !
</Interactive.Div>
);
};
Gardez l'appel interpolate() en ligne dans la propriété style.
Préférez les propriétés CSS scale, translate, rotate à transform.
// 👍 Images clés modifiables en ligne et raccourcis de transformation
style={{
scale: interpolate(frame, [0, 100], [0, 1]),
translate: interpolate(frame, [0, 100], ["0px 0px", "100px 100px"]),
rotate: interpolate(frame, [0, 100], ["20deg", "90deg"]),
}}
// 👎 Les valeurs cachées et les chaînes de transformation deviennent plus difficiles à éditer dans Studio
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 assets dans le dossier public/ à la racine de votre projet.
Utilisez staticFile() pour référencer les fichiers du dossier public/.
Ajoutez la vidéo et l'audio en utilisant @remotion/media.
Ajoutez les images en utilisant le composant <Img>.
Utilisez staticFile() pour les fichiers dans public/ ou passez une URL distante directement :
import { Audio, Video } from "@remotion/media";
import { staticFile } from "remotion";
export const MyComposition = () => {
return (
<>
<Video src={staticFile("video.mp4")} style={{ opacity: 0.5 }} />
<Audio src={staticFile("audio.mp3")} />
<Img src={staticFile("logo.png")} style={{ width: 100, height: 100 }} />
<Video src="https://remotion.media/video.mp4" />
</>
);
};
Pour retarder le contenu, enveloppez-le dans <Sequence> et utilisez from.
Pour limiter la durée d'un élément, utilisez durationInFrames de <Sequence>.
<Sequence> par défaut est un remplissage absolu couvrant la scène.
Pour le contenu en ligne, utilisez layout="none".
const Main = () => {
const {fps} = useVideoConfig();
return (
<AbsoluteFill>
<Sequence name="Arrière-plan">
<Background />
</Sequence>
<Sequence name="Titre" from={30} durationInFrames={60} layout="none">
<Title />
</Sequence>
<Sequence name="Sous-titre" from={60} durationInFrames={60} layout="none">
<Subtitle />
</Sequence>
</AbsoluteFill>
);
}
export const Title = () => {
const frame = useCurrentFrame();
return (
<div
style={{
opacity: interpolate(frame, [0, 60], [0, 1], {
extrapolateRight: "clamp",
extrapolateLeft: "clamp",
easing: Easing.bezier(0.16, 1, 0.3, 1),
}),
}}
>
Titre
</div>
);
};
export const Subtitle = () => {
return <div>Sous-titre</div>;
};
Surlignages et annotations de texte
Voir text-highlights.md pour les surlignages de texte (marqueurs de surlignage), cercles, soulignements, barrés, texte rayé, boîtes et crochets.
Voiceover
Voir voiceover.md pour ajouter un voiceover généré par IA aux compositions Remotion en utilisant ElevenLabs TTS.
Recadrage (Trimming)
Voir trimming.md pour les modèles de recadrage – couper le début ou la fin des animations.
Intégration de vidéos
Voir embedding-videos.md pour des connaissances avancées sur l'intégration de vidéos – recadrage, volume, vitesse, boucle, tonalité.
Montage vidéo
Voir video-editing.md pour structurer des timelines vidéo modifiables dans Remotion Studio.
Intégration audio
Voir audio.md pour les fonctionnalités audio avancées comme le recadrage, le volume, la vitesse, la tonalité.
Transitions
Voir transitions.md pour les modèles de transition de scène.
Effets visuels et pixel
Lors de la création d'un effet visuel, préférez : 1. une animation normale Remotion/HTML/CSS/SVG/filtre/mélange/masque, 2. un effet listé via effects.md, y compris sur le HTML rendu via <HtmlInCanvas>, 3. un createEffect() personnalisé via effects.md lorsque l'utilisateur demande un effet réutilisable/propre au projet, 4. un <HtmlInCanvas onPaint> personnalisé via html-in-canvas.md seulement si aucun effet ne convient.
Pour les superpositions de fuite de lumière, voir light-leaks.md. Docs : https://www.remotion.dev/docs/effects
Effets disponibles : brightness(), contrast(), colorKey(), duotone(), grayscale(), hue(), invert(), saturation(), tint(), linearGradient(), linearGradientTint(), thermalVision(), blur(), linearProgressiveBlur(), radialProgressiveBlur(), zoomBlur(), dropShadow(), glow(), lightTrail(), evolve(), venetianBlinds(), mirror(), scale(), uvTranslate(), xyTranslate(), barrelDistortion(), chromaticAberration(), fisheye(), cornerPin(), wave(), burlap(), emboss(), dotGrid(), halftone(), noise(), noiseDisplacement(), paper(), roughenEdges(), pattern(), pixelate(), pixelDissolve(), scanlines(), speckle(), shine(), shrinkwrap(), vignette(), contourLines(), checkerboard(), halftoneLinearGradient(), gridlines(), whiteNoise(), tvSignalOff(), lines(), rings(), waves(), zigzag(), lightLeak(), starburst().
Contenu 3D
Voir 3d.md pour le contenu 3D dans Remotion avec Three.js et React Three Fiber.
Effets sonores
Lorsque vous devez utiliser des effets sonores, chargez le fichier ./sfx.md pour plus d'informations.
Visualisation audio
Lorsque vous devez visualiser de l'audio (barres de spectre, formes d'onde, effets réactifs aux basses), chargez le fichier ./audio-visualization.md pour plus d'informations.
Légendes
Lorsque vous traitez des légendes ou sous-titres, chargez le skill Remotion Captions pour plus d'informations.
Polices Google
Est la méthode recommandée pour charger les polices dans Remotion. Voir google-fonts.md pour savoir comment charger les polices Google.
Polices locales
Voir local-fonts.md pour savoir comment charger les polices locales.
GIFs
Voir gifs.md pour savoir comment afficher des GIFs synchronisés avec la timeline de Remotion.
Images avancées
Voir images.md pour le dimensionnement et le positionnement des images, les chemins d'images dynamiques et l'obtention des dimensions des images.
Animations Lottie
Voir lottie.md pour intégrer des animations Lottie dans Remotion.
Timing avancé
Voir timing.md pour le timing avancé avec interpolate et l'assouplissement Bézier, ainsi que les ressorts.
Vidéos paramétrables
Voir parameters.md pour rendre une composition paramétrable en ajoutant un schéma Zod.
Mesure des nœuds DOM
Voir measuring-dom-nodes.md pour mesurer les dimensions des éléments DOM dans Remotion.
Mesure du texte
Voir measuring-text.md pour mesurer les dimensions du texte, adapter le texte aux conteneurs et vérifier le débordement.
Utilisation de FFmpeg
Pour certaines opérations vidéo, comme le recadrage de vidéos ou la détection de silence, FFmpeg doit être utilisé. Chargez le fichier ./ffmpeg.md pour plus d'informations.
Détection de silence
Lorsque vous devez détecter et supprimer les segments silencieux de fichiers vidéo ou audio, chargez le fichier ./silence-detection.md.
Durée, dimensions et données dynamiques
Voir calculate-metadata.md pour définir dynamiquement la durée, les dimensions et les props de la composition.
Compositions avancées
Voir compositions.md pour savoir comment définir des images fixes, des dossiers, des props par défaut et comment imbriquer des compositions.
Séquençage avancé
Voir sequencing.md pour plus de modèles de séquençage – délai, recadrage, limitation de la durée des éléments.
Installation de modules
Utilisez npx remotion add pour ajouter de nouveaux packages avec la bonne version :
npx remotion add @remotion/media
Cela s'applique aux packages @remotion/*, mediabunny, @mediabunny/* et zod.
Aperçu du code
Faites-le uniquement si vous pensez que l'utilisateur souhaite voir l'aperçu.
npx remotion studio --no-open
Cela démarrera un processus de longue durée et affichera l'URL du serveur pour l'aperçu. S'il est déjà démarré, l'URL sera affichée.
Optionnel : vérification du rendu d'une seule image
Vous pouvez rendre une seule image avec la CLI pour vérifier la mise en page, les couleurs ou le timing. Ignorer pour les modifications triviales, les refontes pures, ou lorsque vous avez déjà suffisamment confiance grâce au Studio ou aux rendus précédents.
npx remotion still [composition-id] --scale=0.25 --frame=30
À 30 ips, --frame=30 correspond à la marque d'une seconde (--frame est basé sur zéro).