리모션 수학 설명기 (remotion-math-explainer)
개요
모든 수학적 유도, 정리, 증명 또는 슬라이드 덱을 프레임 동기화된 1920×1080 30fps MP4 리모션 설명 영상으로 단일 패널 Log2Base2 스튜디오 형식으로 변환합니다.
화면을 경쟁하는 나란히 있는 패널이나 쌓인 텍스트 카드 벽으로 분할하지 마십시오. 모든 비디오는 하나의 통합된 시각적 스테이지 (<SinglePaneStage>)를 사용하여 시청자의 전체 주의가 시각적 이야기에 고정되도록 합니다:
- 최소 상단 바 (
44px,SinglePaneStage에 내장) :- 왼쪽에는 주제 제목 + 현재 활성 섹션 필; 오른쪽에는 미묘한 단계 카운터 + 얇은 진행률 표시줄.
- 하나의 통합된 Log2Base2 스테이지 (
SinglePaneStage— 100% 너비) :- 집중된 단일 라인 스포트라이트 헤더: 오직 현재 단계 제목과 단일 활성 방정식 라인만 표시합니다 (활성 음성 단어를 제자리에서
borderBottom: "2px solid #FACC15"로 강조 표시하며, 절대 수평 패딩을 추가하지 않음) 그리고triggerFrame에서 스프링 인되는 하나의 컴팩트한 활성 토큰 콜아웃 필 (symbol→평범한 영어 의미)이 포함됩니다. - 전체 너비 몰입형 SVG 캔버스 (
viewBox="0 0 1600 680") : 넉넉하고 연속적인 모션 그래픽 — 라이브 좌표 격자와 늘어나고 접히는 색상 데이터 포인트, 행렬에서 작은 블록으로 물리적으로 미끄러지는 숫자, 휩쓰는 레이저 크로스아웃, 부호 있는 크기 막대, 항등 행렬로 되돌아가는 3D 단위 큐브 — 동일한 열린 캔버스에 직접 통합됩니다.
- 집중된 단일 라인 스포트라이트 헤더: 오직 현재 단계 제목과 단일 활성 방정식 라인만 표시합니다 (활성 음성 단어를 제자리에서
- 최소 하단 자막 바 (
VoiceoverCaptionBar—68px) :- 정확한 TTS
WordBoundary밀리초 타임스탬프에 의해 구동되는 깔끔한 중앙 정렬 워드바이워드 강조 자막.
- 정확한 TTS
종속성
remotion-best-practices(~/.gemini/skills/remotion/SKILL.md): 모든 Remotion 애니메이션 규칙 (useCurrentFrame(),interpolate(),spring(),<Sequence premountFor>,<Audio>,@remotion/google-fonts, 제로 CSS 트랜지션)에 대해 따라야 합니다.uv(~/.gemini/config/plugins/science/skills/uv/SKILL.md): 신경망 음성 해설 합성을 위해uv run --with edge-tts를 실행하는 데 필요합니다.
빠른 시작
# 1. 리모션 수학 설명기 프로젝트 스캐폴드
uv run python3 \
~/.gemini/config/skills/remotion-math-explainer/scripts/explainer_cli.py \
scaffold \
--project-dir "/path/to/project" \
--output "/path/to/project/scaffold-status.json"
# 2. 자연스러운 신경망 음성 해설 + 정확한 WordBoundary 및 용어 타임스탬프 합성
uv run --with edge-tts python3 \
~/.gemini/config/skills/remotion-math-explainer/scripts/explainer_cli.py \
synthesize-voiceover \
--project-dir "/path/to/project" \
--beats-json "/path/to/project/beats.json" \
--voice "en-US-AndrewNeural" \
--rate "+2%" \
--pause-sec 0.40 \
--output "/path/to/project/public/voiceover/manifest.json"
# 3. 빠른 8-워커 키프레임 중복 제거 렌더러를 통해 최종 1080p 30fps MP4 렌더링
uv run python3 \
~/.gemini/config/skills/remotion-math-explainer/scripts/explainer_cli.py \
render-mp4 \
--project-dir "/path/to/project" \
--composition-id "MathExplainer" \
--out-name "MathExplainer.mp4" \
--concurrency 8 \
--output "/path/to/project/render-report.json"
몰입형 스토리텔링 및 워크플로우
- 에너제틱 비트 설계 (
beats.json) :- 대화형, 훅 우선 내레이션 작성 (건조한 교과서 문체 피하기)하여 동기 부여가 부족한 학생도 참여를 유지합니다.
snippet을 2–4개의 선명한 라인으로 유지하고 각token이 한 줄에 그대로 나타나며text의 깔끔한 단일 소문자triggerWord와 일치하도록 합니다.- 연속적인 곡선, 벡터, 격자 또는 비행 요소 애니메이션이 있는 비트에 대해
"motionStepFrames": 2로 설정합니다.
- 음성 해설 스캐폴드 및 합성:
scripts/explainer_cli.py를 통해scaffold(SinglePaneStage.tsx,VoiceoverCaptionBar.tsx,render_full_mp4.mjs복사) 및synthesize-voiceover를 실행합니다.
- 전체 캔버스 모션 그래픽 작성 (
viewBox="0 0 1600 680") :- 몰입형 SVG 스테이지를
children으로<SinglePaneStage>에 전달합니다. - 보여주세요, 말하지 마세요: 정적 글머리 기호/텍스트 카드를 물리적 모션으로 대체 — 좌표 왜곡을 타는 입자/포인트, 위치 사이를 비행하는 요소, 휩쓰는 레이저 라인, 라이브 게이지, 동일한 열린 캔버스 안에 나란히 있는 라이브 플롯.
- 왜곡/확장 그리드라인은 항상
<clipPath>안에 감싸서 모션이 레이블이나 필을 넘어 흐르지 않도록 합니다.
- 몰입형 SVG 스테이지를
- 스틸 확인 및 최종 MP4 렌더링:
render-mp4를 실행하기 전에npm run lint를 실행하고read_file로 대표 스틸 프레임 (npx remotion still)을 검사합니다.- 최종
.mp4를out/, 프로젝트 루트, 작업 공간 루트에 복사합니다.
속도 제한 및 일반적인 실수
scripts/explainer_cli.py는/tmp/remotion_edge_tts.lock을 적용합니다 (0.35s간격,1s/2s/4s백오프로 3회 재시도).- 절대 다중 패널 분할 화면 레이아웃을 사용하거나 테두리가 있는 하위 카드를 쌓지 마십시오 —
<SinglePaneStage>를 사용하여 엄격하게 하나의 기본 창만 화면에 표시되도록 합니다. - 절대 한 번에 전체 다단계 증명을 화면에 덤프하지 마십시오; 한 번에 하나의 활성 방정식 라인과 하나의 활성 콜아웃 필을 스포트라이트합니다.
- 절대 강조 표시된 인라인 토큰에 수평
padding을 추가하지 마십시오 (borderBottom: "2px solid #FACC15"및backgroundColor만 사용).