企业官网建设流程全解析

Manim 音频同步快速上手：BGM、音效与旁白对齐

【免费下载链接】manimA community-maintained Python framework for creating mathematical animations.项目地址: https://gitcode.com/GitHub_Trending/man/manim

音乐一响，圆变方早就演完了，鼓点才刚起步——这是 Manim 音频同步没对齐时的真实现场。这篇教程带你在 Manim 里完成三件事：铺一段循环背景音乐、在动画节点卡进点击音效、用旁白插件让画面自动跟随语音时长。

先听到声音：一行代码给 Manim 加背景音乐 🔊

最快路径就是一行add_sound。把bgm.mp3放进assets/目录，在场景开头加一句，渲染完打开 mp4 就能听到音乐。

class SquareToCircle(Scene): def construct(self): # 音频放 assets/ 目录，渲染时自动混进音轨 self.add_sound("bgm.mp3") square = Square() self.play(Create(square)) self.play(Transform(square, Circle())) self.play(FadeOut(square))

三个细节值得知道。路径解析在 manim/utils/sounds.py，只认.wav和.mp3两种后缀，.flac想都别想。声音的起点是调用那一刻的场景时间self.time，写在哪个动画之后，就从那一秒起播——这对你意味着：不用对照时间轴手算，代码写到哪里，声音就跟到哪里。音频比视频短，结尾会有一段干画面，BGM 长度最好盖住全片。

把声音拆成三层

把声音想象成电影混音台：垫底的、点缀的、讲事的，各走各的轨道。Manim 的音轨也一样，时间轴像一卷胶带，每次add_sound就是往某一秒贴一张标签。

BGM 层用add_sound铺底。gain单位是 dB，-10就是压低 10 分贝，别让它盖过前景。它没有loop参数，想循环就手动再贴一次标签：

class Mix(Scene): def construct(self): # BGM 层：铺底并压低 10dB，别抢前景 self.add_sound("bgm.mp3", gain=-10) # 30 秒的短曲想循环？往后 30 秒再贴一遍 self.add_sound("bgm.mp3", time_offset=30) dot = Dot() self.play(FadeIn(dot)) # 事件层：写到哪一秒，就在哪一秒响 self.add_sound("click.wav")

事件层给关键动作配音效。先纠一个流传很广的误会：Manim 源码里没有play_sound函数，事件音同样走add_sound，时机由调用位置决定，签名见 manim/scene/scene.py。这对你意味着：把调用写在动画之后，音效就永远贴在那个动作上，重排动画也不脱节。

旁白层不自己算时间，交给 manim-voiceover 插件。安装manim-voiceover后用VoiceoverScene替换Scene，官方用法见 docs/source/guides/add_voiceovers.rst：

from manim_voiceover import VoiceoverScene class Narrated(VoiceoverScene): def construct(self): # 动画时长不写死，直接取语音时长 with self.voiceover(text="圆开始绘制") as tracker: self.play(Create(Circle()), run_time=tracker.duration)

卡准节奏：wait、run_time 到 tracker.duration

三档对齐手法，由易到难，按素材稳定性选。

第一档wait()。BGM 节奏稳定时人肉对拍，在动画之间塞固定等待。缺点是换一首曲子，所有数字要重改。time_offset也能挪声音：add_sound("click.wav", time_offset=2)表示从当前时刻往后 2 秒响。

第二档run_time。动画时长直接对齐节拍间隔，1.5 秒一段鼓点就写 1.5：

def construct(self): # 第一档：固定等待，人肉对拍 self.play(FadeIn(square)) self.wait(1.5) # 给 BGM 留 1.5 秒呼吸 # 第二档：动画时长对齐节拍间隔 self.play( Transform(square, circle), run_time=1.5, # 1.5 秒后正好接下一声鼓点 )

第三档tracker.duration。上面旁白层那段代码就是这个用法：动画时长取旁白音频的实际时长。这对你意味着：改词重录，画面永远跟着语音走，不用回头改任何数字。

不出声时：5 条自检清单 ✅

1. 查路径：解析器只在assets_dir里找.wav/.mp3，.ogg改后缀也找不到。
2. 查编码：MP3 会被 ffmpeg 自动转成 16bit PCM 的 WAV，日志会打印Automatically converted ... to .wav；没这行还报错，多半是源文件损坏，重新导出 16bit、44.1kHz 的版本。
3. 查 manim.cfg：默认assets_dir = ./，即你敲命令的目录；显式在[CLI]段写assets_dir = ./assets，默认值定义在 manim/_config/default.cfg。
4. 查导出：add_sound开头就是if self.renderer.skip_animations: return，带跳过动画参数渲染时整条音轨是空的；正常出片确认[CLI]段write_to_movie = True。
5. 查时长：BGM 短于视频，尾巴必然静音；time_offset给负数会抛ValueError，别想倒着贴。

行动清单

1. 改配置：在 manim.cfg 的[CLI]段加一行assets_dir = ./assets，把bgm.mp3放进该目录。
2. 跑场景：把 example_scenes/basic.py 里的SquareToCircle拷到本地，加一行self.add_sound("bgm.mp3")，用manim -p渲染。
3. 验输出：打开media/videos下的 mp4，前 10 秒确认三件事——音乐起得来、音效卡得准、结尾不静音。

【免费下载链接】manimA community-maintained Python framework for creating mathematical animations.项目地址: https://gitcode.com/GitHub_Trending/man/manim