remotion-video

用 React 以编程方式创建 MP4 视频的框架。 选择模板后： 为视频添加 AI 语音解说，实现音视频同步。支持两种方案： 云端 API 方案，无需本地 GPU，生成速度极快，音色克隆效果优秀。 ⚠️ 常见错误 ： api.minimax.chat 是 错误的域名 ，会返回 "invalid api key"。请确认使用上表中的正确域名。 使用 scripts/generate_audio_minimax.py 生成音频，支持： ❌ 错误写法 ：在 f-string 中使用 \n 会产生字面量字符 ✅ 正确写法 ：分开处理字符串拼接 无需特殊硬件，完全免费，适合不需要克隆音色的场景。 使用 scripts/generate_audio_edge.py 生成音频： 教程、讲解类视频的核心架构： 音频驱动场景切换 。 关键思想： 参见 templates/audioConfig.ts ，包含： ⚠️ 不要用 position += (target - position) * factor 这种写法 ，永远无法精确收敛，会导致画面持续抖动。详见「🚨 3D 场景常见陷阱 - 陷阱1」。 使用 React Three Fiber 在 Remotion 中创建 3D 动画视频。 官方模板 （推荐新手）： 安装 drei （React Three Fiber 工具库）： 渲染时使用 useOffthreadVideoTexture() 确保帧精确： 用基础几何体组合角色（无需专业建模）： 问题 ：多个 3D 场景同时渲染时报错 Error creating WebGL context 原因 ：浏览器限制 WebGL 上下文数量（通常 8-16 个） 解决方案 ： CLI 渲染时： 服务端渲染（SSR）必须配置 gl 选项： 内部的 useCurrentFrame() 返回的是 相对于 Sequence 开始的帧号 ，不是全局帧号。 针对教程、讲解类视频，借鉴 3Blue1Brown 的可视化设计原则。 2D 模式实现 ：使用正交相机 + 扁平几何体 核心 ：用 delay 参数控制元素依次出现 ❌ 宣布式（避免） ： ✅ 探索式（推荐） ： 脚本结构模板 ： 核心理念 ：不只展示「是什么」，更要展示「怎么算」。让观众亲眼看到数据如何流动、计算如何发生。 关键转变 ：脚本需要配合动画节奏，给动画「留白时间」。 ❌ 传统脚本（信息密集） ： ✅ 过程动画脚本（留白配合） ： 示例：卷积场景时间分配 症状 ：画面一直微微放大-缩小抖动 错误写法 ： 正确写法 ： 症状 ：本应显示为正常方向的图像（如数字7）被旋转了90度 根因 ：图像处理中 row 对应 y 轴（从上到下）， col 对应 x 轴（从左到右）， 但代码里把行索引映射到了 x 坐标，列索引映射到了 y 坐标。 错误写法 ： 正确写法 ： 记忆口诀 ： 音频生成和视频渲染都可能耗时较长， 务必使用前台执行 以便看到进度： render.sh 示例 ： 长时间任务（如批量生成音频）应支持断点续作： Q: 视频渲染很慢？ Q: 字体不显示？ Q: 视频素材不播放？ - Composition - 视频的定义（尺寸、帧率、时长） - useCurrentFrame() - 获取当前帧号，驱动动画 -...