Framer Motion Integration
Framer Motion Animationen sind normalerweise zeitbasiert. Um sie mit Helios (das frame-basiert und scrubbable ist) zu synchronisieren, musst du den Helios-Frame-Status auf MotionValues abbilden.
Schnellstart
1. useVideoFrame Hook
Stelle sicher, dass du den useVideoFrame-Hook hast (siehe examples/react/SKILL.md).
2. Frames auf MotionValues abbilden
Verwende useTransform, um den aktuellen Frame (von useVideoFrame) auf Animationswerte abzubilden.
import { useMotionValue, useTransform, motion } from 'framer-motion';
import { useVideoFrame } from './hooks/useVideoFrame';
export const MyComponent = ({ helios }) => {
// 1. Aktuellen Frame abrufen
const frame = useVideoFrame(helios);
// 2. Ein MotionValue für den Frame erstellen
const frameMv = useMotionValue(0);
// MotionValue bei jeder Frame-Änderung synchronisieren
useEffect(() => {
frameMv.set(frame);
}, [frame, frameMv]);
// 3. Frame -> Animationswert transformieren
// Beispiel: 360 Grad über 60 Frames drehen (0 bis 60)
const rotate = useTransform(frameMv, [0, 60], [0, 360]);
// Beispiel: Deckkraft über die ersten 30 Frames einblenden
const opacity = useTransform(frameMv, [0, 30], [0, 1]);
return (
<motion.div
style={{
width: 100,
height: 100,
background: 'blue',
rotate, // Transformierten Wert binden
opacity
}}
/>
);
};
Fortgeschritten: Manuelles Setzen des MotionValue
Für eine bessere Leistung in tiefen Komponentenbäumen kannst du ein gemeinsames MotionValue direkt im Subscription-Callback aktualisieren und so den React-Rerender umgehen.
const frameMv = useMotionValue(0);
useEffect(() => {
const unsubscribe = helios.subscribe((state) => {
// MotionValue direkt aktualisieren - kein React-Rerender!
frameMv.set(state.currentFrame);
});
return unsubscribe;
}, [helios, frameMv]);
const x = useTransform(frameMv, [0, 100], [0, 500]);
return <motion.div style={{ x }} />;
Quelldateien
- Beispiel:
examples/framer-motion-animation/