manim 移动端适配指南：3 步让数学动画在手机上正常播放

manim 移动端适配指南：3 步让数学动画在手机上正常播放

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

你把自己渲染好的 10 秒数学动画发给学生，对方用手机打开，画面被裁掉一半，文件十几 MB，还卡。manim 移动端适配其实只改三个地方：竖屏画布、分辨率与帧率、输出格式，下面按顺序拆开讲。

manim 手机动画的三个典型症状

竖屏裁剪。manim 默认输出 1920×1080，是 16:9 横屏。放到竖着拿的手机里，要么上下留两条大黑边，要么全屏后只剩中间一条横带，关键公式可能被挤到屏幕外。

解码卡顿。1080p、60fps 在电脑上很顺，中低端手机的解码跟不上，复杂公式和密集线条多的场景会明显掉帧。

文件臃肿。同样 10 秒的动画，高质量版本动辄 10 MB 以上，手机下载慢，聊天软件还会再压一轮。

manim 移动端渲染的三层机制

最终视频由三层依次决定，适配时先分清在哪层动手。

配置层：manim.cfg 的 [CLI] 段和命令行参数，定像素尺寸（pixel_width / pixel_height）、帧率（frame_rate）、格式。仓库里的 默认配置文件 就是这一层的默认值来源。

画布层：frame_width 和 frame_height 是逻辑坐标系，默认高 8 个单位。内容先在这个坐标系里排版，再整体缩放到像素，竖屏适配主要在这一层动手。

编码层：视频编码和容器格式，决定文件体积和播放兼容性，微调用。

一句话记：画布层管"画面长什么样"，配置层管"出多大、多少帧"，编码层管"费多少流量"。

manim 竖屏配置的三个入口优先级

同一参数在三个地方都能设，冲突时 manim 按从低到高取：manim.cfg < 命令行参数 < 代码里 config.xxx 赋值，规则可见 官方配置文档。

把竖屏规格写进 manim.cfg，谁都不用再加参数：

[CLI] pixel_width = 720 pixel_height = 1280

一次性交付用命令行最省事：

manim -qm -r 720,1280 scene.py MobileScene

-r 单独指定宽、高，就是为非 16:9 的 manim 竖屏准备的。

竖屏画布设置方法：9:16 下 frame_height 怎么取

先定像素比例，再定逻辑画布。把像素设成 720×1280（9:16）后，若 frame_width 不写，manim 会按 frame_height×像素比例自动算，默认得到 8×9/16=4.5 个单位宽，画面变窄条，内容通常要重排。

常见摆法：frame_height 直接取 16，frame_width 自动跟成 9，整屏 9 宽 16 高。这是 manim 响应式分辨率最直接的做法。配套两条规则：

• 安全区：上下各留 0.8 个单位的 buff，避开刘海和底部手势条；
• 字号：主文字 font_size 取 32 左右，约是 9 单位屏宽的 1/4，辅助文字再降一档。

三行关键代码：

config.pixel_width, config.pixel_height = 720, 1280 config.frame_height = 16 # frame_width 自动为 9 title.to_edge(UP, buff=0.8)

config 要在场景创建 Mobject 之前设好，因为对象尺寸是按当时画布算的。

manim 输出格式选择与质量档位

格式用短句说清：

• MP4（H.264）：兼容性最好的视频封装，手机分发首选；
• WebM：同画质下文件更小，适合手机浏览器和网页嵌入；
• GIF：无声音、体积大，只适合 3 秒以内的小动画。

质量档位对应固定规格，取自 manim 的 QUALITIES 定义：

竖屏时档位只管帧率参考，分辨率要配合 -r 改比例。

移动端帧率与质量取舍：实测数据

取一个 12 段动画、总长 10 秒的场景，同一台机器实测：

手机分发取 720p 竖屏加 30fps 这个平衡点：渲染耗时只比最低档多六成，体积却只有高质量档的一半左右。

翻车清单：五个常见症状

症状：竖屏视频上下仍有大黑边。原因：只改了像素尺寸，frame_height 还是 8，内容溢出 4.5 单位宽的画布。修法：把 config.frame_height 设为 16 并重排。

症状：电脑流畅，手机卡。原因：60fps 加 1080p，低端机解码吃力。修法：换 -qm 或加 --fps 30。

症状：发到聊天软件后变糊。原因：文件超过平台免压缩阈值，被二次压缩。修法：分发用 -qm 版，高质量版只存档。

症状：竖屏画面大片留白。原因：内容还按 16:9 的 14.2×8 单位布局，宽度超出。修法：改竖排，to_edge 加 arrange(direction=DOWN)。

症状：manim.cfg 里设了不生效。原因：命令行或代码里的赋值优先级更高，覆盖了它。修法：打印 config.pixel_height 核对实际值，或统一在一处设置。

manim 移动端适配快速上手清单

• 先定分发渠道：手机竖屏 720×1280，平板横屏 1080p
• 场景代码里先设 pixel 尺寸和 frame_height=16，再建对象
• 上下边距 buff 取 0.8 以上，主文字 font_size 约 32
• 帧率固定 30，不做 60
• 格式选 MP4，需要静帧时另出一张 PNG
• 渲染完先在真机上播一遍，确认无裁剪、不卡

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