Ceci est un guide pour l'écriture de balisage React avec Remotion. Si cela n'est pas pertinent, chargez plutôt Bonnes pratiques Remotion.
Règles générales
Animez les propriétés en utilisant useCurrentFrame() et interpolate().
Utilisez interpolate() plutôt que 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 du sens pour être rendus interactifs dans le Studio doivent utiliser Interactive : <div> -> <Interactive.Div>.
Définissez une propriété name descriptive comme name="Titre principal" pour Interactive, Solid, Sequence.
import { useCurrentFrame, Easing, interpolate, Interactive } from "remotion";
export const Fondu = () => {
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 propriétés CSS abrégées pour les transformations
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 caractères transform deviennent plus difficiles à éditer dans le Studio
const scale = interpolate(frame, [0, 100], [0, 1]);
style={{
transform: `scale(${scale})`,
}}
Les transitions ou animations CSS sont INTERDITES - elles ne se rendront pas correctement. Les noms de classes d'animation Tailwind sont INTERDITS - ils ne se rendront pas correctement.
Placez les ressources dans le dossier public/ à la racine de votre projet.
Utilisez staticFile() pour référencer les fichiers du dossier public/.
Ajoutez des vidéos et de l'audio en utilisant @remotion/media.
Ajoutez des 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 MaComposition = () => {
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>.
Par défaut, <Sequence> est un remplissage absolu couvrant la scène.
Pour le contenu en ligne, utilisez layout="none".
const Principal = () => {
const { fps } = useVideoConfig();
return (
<AbsoluteFill>
<Sequence name="Fond">
<Fond />
</Sequence>
<Sequence name="Titre" from={30} durationInFrames={60} layout="none">
<Titre />
</Sequence>
<Sequence name="Sous-titre" from={60} durationInFrames={60} layout="none">
<SousTitre />
</Sequence>
</AbsoluteFill>
);
};
export const Titre = () => {
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 SousTitre = () => {
return <div>Sous-titre</div>;
};
Cartes
Voir cartographie.md pour choisir entre des cartes statiques simples, des cartes Mapbox et des cartes MapLibre.
Voix off
Voir voix-off.md pour ajouter une voix off générée par IA aux compositions Remotion en utilisant ElevenLabs TTS.
Rognage
Voir rognage.md pour les motifs de rognage - couper le début ou la fin des animations.
Incorporation de vidéos
Voir incorporation-videos.md pour des connaissances avancées sur l'incorporation de vidéos - rognage, volume, vitesse, bouclage, hauteur.
Incorporation audio
Voir audio.md pour les fonctionnalités audio avancées comme le rognage, le volume, la vitesse, la hauteur.
Transitions
Voir transitions.md pour les motifs de transition de scène.
Effets visuels et pixel
Lors de la création d'un effet visuel, privilégiez : 1. une animation normale Remotion/HTML/CSS/SVG/filtre/mélange/masque, 2. un effet listé via effets.md, y compris sur du HTML rendu via <HtmlInCanvas>, 3. un createEffect() personnalisé via effets.md lorsque l'utilisateur demande un effet réutilisable/spécifique au projet, 4. un <HtmlInCanvas onPaint> personnalisé via html-in-canvas.md uniquement si aucun effet ne convient.
Pour les superpositions de fuite de lumière, voir light-leaks.md. Documentation : 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 en utilisant Three.js et React Three Fiber.
Effets sonores
Lorsque vous avez besoin d'utiliser des effets sonores, chargez le fichier ./sfx.md pour plus d'informations.
Visualisation audio
Lorsque vous avez besoin de visualiser de l'audio (barres de spectre, formes d'onde, effets réactifs aux basses), chargez le fichier ./audio-visualisation.md pour plus d'informations.
Sous-titres
Lorsque vous traitez des sous-titres ou des légendes, chargez la compétence Sous-titres Remotion pour plus d'informations.
Polices Google
C'est la méthode recommandée pour charger des polices dans Remotion. Voir polices-google.md pour savoir comment charger des polices Google.
Polices locales
Voir polices-locales.md pour savoir comment charger des 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'image dynamiques et l'obtention des dimensions des images.
Animations Lottie
Voir lottie.md pour incorporer des animations Lottie dans Remotion.
Timing avancé
Voir timing.md pour le timing avancé avec interpolate et l'assouplissement Bézier, et les ressorts.
Vidéos paramétrées
Voir parametres.md pour rendre une composition paramétrable en ajoutant un schéma Zod.
Mesure des nœuds DOM
Voir mesure-noeuds-dom.md pour mesurer les dimensions des éléments du DOM dans Remotion.
Mesure du texte
Voir mesure-texte.md pour mesurer les dimensions du texte, ajuster le texte aux conteneurs et vérifier le débordement.
Utilisation de FFmpeg
Pour certaines opérations vidéo, telles que le rognage 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 rogner les segments silencieux de fichiers vidéo ou audio, chargez le fichier ./detection-silence.md.
Durée, dimensions et données dynamiques
Voir calcul-metadonnees.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 sequencage.md pour plus de motifs de séquençage - délai, rognage, 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 balisage
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 imprimera l'URL du serveur pour l'aperçu. S'il est déjà démarré, l'URL sera imprimée.
Optionnel : vérification de 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. Sautez cette étape 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 [id-composition] --scale=0.25 --frame=30
À 30 images par seconde, --frame=30 correspond à la marque d'une seconde (--frame est basé sur zéro).