Quand utiliser
Utilisez cette compétence lorsque vous travaillez avec du code Remotion afin d'obtenir les connaissances spécifiques au domaine.
Configuration d'un nouveau projet
Lorsque vous vous trouvez dans un dossier ou un espace de travail vide sans projet Remotion existant, créez-en un avec :
npx create-video@latest --yes --blank --no-tailwind my-video
Remplacez my-video par un nom de projet approprié.
Concevoir une vidéo
Animez des propriétés en utilisant useCurrentFrame() et interpolate(). Utilisez Easing pour personnaliser le timing de l'animation.
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 }}>Bonjour le monde !</div>;
};
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 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> depuis @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> depuis @remotion/media :
import { Audio } from "@remotion/media";
import { staticFile } from "remotion";
export const MyComposition = () => {
return <Audio src={staticFile("audio.mp3")} />;
};
Les assets peuvent également être référencés par des URL distantes :
import { Video } from "@remotion/media";
export const MyComposition = () => {
return <Video src="https://remotion.media/video.mp4" />
};
Pour retarder 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 }}>Titre</div>;
};
export const Subtitle = () => {
return <div>Sous-titre</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 aussi ê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émarrage de l'aperçu
Lancez le studio Remotion pour prévisualiser une vidéo :
npx remotion studio
Optionnel : rendu d'une seule image pour vérification
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 refactorisations pures ou lorsque vous avez déjà suffisamment de confiance grâce au studio ou aux 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 travaillez avec des sous-titres (captions), 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.
Contenu 3D
Voir rules/3d.md pour le contenu 3D dans Remotion avec Three.js et React Three Fiber.
Audio avancé
Voir rules/audio.md pour les fonctionnalités audio avancées comme le rognage, le volume, la vitesse, la hauteur tonale.
Durée, dimensions et données dynamiques
Voir rules/calculate-metadata.md pour définir dynamiquement la durée, les dimensions et les propriétés des compositions.
Compositions avancées
Voir rules/compositions.md pour savoir comment définir des images fixes, des dossiers, des propriétés par défaut et comment imbriquer des compositions.
Polices Google
Est la méthode recommandée pour charger des polices dans Remotion. Voir rules/google-fonts.md pour savoir comment charger les polices Google.
Polices locales
Voir rules/local-fonts.md pour savoir comment charger des polices locales.
Obtenir la durée audio
Voir rules/get-audio-duration.md pour obtenir la durée d'un fichier audio en secondes avec Mediabunny.
Obtenir les dimensions vidéo
Voir rules/get-video-dimensions.md pour obtenir la largeur et la hauteur d'un fichier vidéo avec Mediabunny.
Obtenir la durée vidéo
Voir rules/get-video-duration.md pour obtenir la durée d'un fichier vidéo en secondes avec Mediabunny.
GIFs
Voir rules/gifs.md pour savoir comment afficher des GIFs synchronisés avec la timeline de Remotion.
Images avancées
Voir rules/images.md pour le dimensionnement et le positionnement des images, les chemins d'images dynamiques et l'obtention des dimensions d'image.
Light leaks (fuites de lumière)
Voir rules/light-leaks.md pour les effets de superposition de fuites de lumière avec @remotion/light-leaks.
Animations Lottie
Voir rules/lottie.md pour intégrer des animations Lottie dans Remotion.
HTML dans un canvas
Voir rules/html-in-canvas.md si vous devez afficher du HTML dans un <canvas> pour appliquer des effets 2D ou WebGL via <HtmlInCanvas>.
Mesure des nœuds DOM
Voir rules/measuring-dom-nodes.md pour mesurer les dimensions d'éléments du DOM dans Remotion.
Mesure du texte
Voir rules/measuring-text.md pour mesurer les dimensions du texte, adapter le texte à des conteneurs et vérifier le débordement.
Séquençage avancé
Voir rules/sequencing.md pour d'autres motifs de séquençage – retarder, rogner, limiter la durée d'éléments.
TailwindCSS
Voir rules/tailwind.md pour utiliser TailwindCSS dans Remotion.
Animations de texte
Voir rules/text-animations.md pour la typographie et les motifs d'animation de texte.
Timing avancé
Voir rules/timing.md pour le timing avancé avec interpolate et les courbes de Bézier, ainsi que les ressorts.
Transitions
Voir rules/transitions.md pour les motifs de transitions de scène.
Vidéos transparentes
Voir rules/transparent-videos.md pour effectuer le rendu d'une vidéo avec transparence.
Rognage
Voir rules/trimming.md pour les motifs de rognage – couper le début ou la fin d'animations.
Vidéos avancées
Voir rules/videos.md pour des connaissances avancées sur l'intégration de vidéos – rognage, volume, vitesse, boucle, hauteur tonale.
Vidéos paramétrées
Voir rules/parameters.md pour rendre une composition paramétrable en ajoutant un schéma Zod.
Cartes
Pour des cartes simples avec de petits survols, envisagez d'utiliser des images de carte statiques. Pour des cartes complexes avec des itinéraires animés ou des survols, chargez la règle cartes : rules/maplibre.md
Voiceover
Voir rules/voiceover.md pour ajouter une voix off générée par IA aux compositions Remotion en utilisant ElevenLabs TTS.