PPT转视频 使用教程
适用插件：PPT转视频
本教程按插件 v1.0.0 的实际功能编写。
本插件在 Windows 上调用已安装的 Microsoft PowerPoint 导出视频。
请确保 Microsoft PowerPoint 已经安装
一、这个插件能做什么
PPT转视频用于把一个或多个 PowerPoint 演示文稿批量导出为 MP4 视频。
主要功能包括：
批量转换多个 PPT 文件。
扫描子文件夹，并在输出目录中保留对应层级。
设置导出分辨率、帧率、视频倍速和每页停留时间。
保留或移除 PowerPoint 导出的原音频。
给视频加入一首或多首背景音乐。
暂停、继续或在离开插件时取消转换队列。
显示每个文件的进度和失败原因。
当前实际支持的演示文稿格式：
.ppt
.pptx
.pps
.ppsx
当前不会自动加载 .pptm、.pot、.potx、PDF 等格式。需要处理这些文件时，请先在 Microsoft PowerPoint 中另存为 .pptx。
二、开始前必须准备什么
1. Windows电脑
本插件通过 Windows PowerShell 和 PowerPoint 的 Windows 自动化能力工作，不能在 macOS 或 Linux 上使用。
2. Microsoft Office PowerPoint 2013或以上版本
电脑上必须安装桌面版 Microsoft PowerPoint 2013 或更高版本。以下软件不能替代这一要求：
只有网页版 PowerPoint。
只有手机端 PowerPoint。
仅安装 WPS，但没有安装 Microsoft PowerPoint。
只有 PowerPoint Viewer。
如果插件提示“无法启动 Microsoft PowerPoint”，请先确认 Microsoft PowerPoint 本身可以正常打开。
3. 可正常打开的源文件
请先用 PowerPoint 手动打开几个源文件，检查：
文件没有损坏。
文件没有打开密码。
字体、图片、视频和音频没有缺失。
外部链接的媒体文件仍然可以访问。
动画和切换效果可以正常播放。
建议在批量转换前关闭正在编辑的源演示文稿，避免文件占用或保存提示影响导出。
4. 足够的磁盘空间和时间
PPT转视频通常比普通文件格式转换慢。视频越清晰、帧率越高、页数越多、动画越复杂，耗时和磁盘占用越大。
建议：
输出文件夹至少保留源 PPT 总大小数倍的可用空间。
先用一个短 PPT 做测试，确认画面和声音。
大批量任务期间接通电源，不让电脑自动睡眠。
5. FFmpeg资源
普通的 1x 视频导出由 PowerPoint 完成。以下功能还需要工具箱提供的 FFmpeg 资源：
视频倍速不是 1x。
开启“静音PPT原音频”。
开启“加入背景音乐”。
插件安装包声明了所需 FFmpeg 和 FFprobe 资源。若提示“未检测到主体共享 FFmpeg”，请先更新或重新安装对应插件资源，仍无法恢复时联系技术支持。不要从不可信网站随意下载可执行文件替换。
6. 了解失败文件移动规则
当前界面没有关闭这一规则的开关：某个 PPT 转换失败时，插件会把该源文件移动到所选“PPT文件夹”根目录下的“失败”文件夹。
例如：
PPT文件夹：D:\待转换PPT 失败文件夹：D:\待转换PPT\失败 如果“失败”文件夹中已有同名文件，新移入的文件会自动加上 1、2 等后缀，避免直接覆盖。
递归扫描时，插件会跳过名称正好为“失败”的文件夹，防止失败文件被下一次批量任务自动重复处理。
由于失败时会移动源文件，重要资料在开始前一定要备份。正常完成的源文件不会被移动。
三、如何进入插件
打开吉米工具箱。
进入“本地应用”列表。
找到“PPT转视频”。
单击插件卡片或名称，进入插件页面。
页面右上角有：
返回：回到本地应用列表。
置顶：让插件窗口保持在其他窗口前面；再次单击可取消。
版本标签：显示当前插件版本。
插件有两个标签页：
操作：选择 PPT、选择输出文件夹、管理转换队列。
配置：设置视频参数和音频。
四、操作页面说明
1. PPT文件夹
指定源演示文稿所在的文件夹。选择后会自动加载支持的 PPT 文件。
2. 视频文件夹
指定 MP4 输出位置。
3. 加载文件
重新扫描 PPT 文件夹并重建文件列表。以下情况建议单击：
新增、删除或移动了源文件。
修改了“包含子文件夹”。
上次任务结束后准备重新转换。
4. 开始转换
建立转换队列，并按照列表顺序逐个处理文件。每次只处理一个 PPT，完成后再处理下一个。
5. 暂停 / 继续
“暂停”只暂停队列继续取下一个文件。当前已经交给 PowerPoint 的文件会继续导出，完成后队列才停住。
暂停后按钮显示“继续”。单击后处理剩余文件。
6. 包含子文件夹
关闭：只加载 PPT 文件夹最外层的文件。
开启：同时加载所有子文件夹，但会跳过名为“失败”的文件夹。
7. 文件列表
列表显示文件名、进度和状态。
单击文件名可以复制名称或相对路径。
在某一行上单击鼠标右键，再选“移除”，可把文件移出本次队列，不会删除源文件。
单击“清空”会清空列表，不会删除源文件。
任务运行期间不能移除或清空。
列表底部可以选择每页显示 10、20、50 或 100 条。
状态标签可筛选列表。实际转换主要使用“等待中”“处理中”“已完成”“失败”和“已取消”。界面中的“已跳过”统计通常不会由当前转换流程主动产生。
五、配置页面：视频参数
配置会自动保存。再次打开插件时可能沿用上次设置，所以每次新任务都应重新核对。
1. 导出分辨率
可选：
分辨率只影响输出 MP4，不会修改源 PPT。源图片本来较模糊时，选择 4K 也不会自动提升素材清晰度。
2. 导出帧率
可选 24、25、30、50、60 fps。
24 fps：画面风格更接近电影，文件和计算量相对较低。
25 fps：常见视频帧率之一。
30 fps：默认值，适合大多数演示文稿。
50或60 fps：转场和动画更顺滑，但导出时间和文件体积通常更大。
如果 PPT 主要是静态页面，使用 50/60 fps 的提升通常不明显，建议使用 30 fps。
3. 视频倍速
可选：
0.25x、0.5x、0.75x、1x、1.25x、1.5x、1.75x、2x、2.5x、3x 规则：
1x：不做倍速后处理。
大于 1x：视频变快，总时长变短。
小于 1x：视频变慢，总时长变长。
如果 PowerPoint 导出的视频中有音频，插件会让该音频与画面一起变速。
倍速完成后才会加入背景音乐，因此背景音乐按最终视频长度循环或截断。
倍速需要 FFmpeg，并会增加额外处理时间。极端倍速可能降低听感或画面观感。讲解类内容可以先试 1.25x；不确定时使用 1x。
4. 每页停留时间
可选 1 至 15 秒，默认 5 秒。
它用于控制没有足够现成计时信息时，每页默认停留多久。插件会把短于所选值的页面计时提高到所选值；已有更长计时、旁白或动画时，实际时长可能更长。
建议：
快速浏览：2至3秒。
普通展示：5秒。
每页文字较多：8至12秒。
最终时长还会受 PowerPoint 动画、切换、旁白和嵌入媒体影响。务必先转换一个样例并完整播放。
5. 导出质量
当前界面不提供可调整的质量选项，插件使用固定的内部导出质量值 85。用户只需要选择分辨率和帧率，不要寻找额外的“质量”开关。
六、配置页面：音频设置
1. 支持的背景音乐格式
当前支持：
.mp3
.wav
.m4a
.aac
.flac
.ogg
.wma
2. 添加音频
方法一：单击音频文件列表右上角的“添加”，在文件选择窗口中一次选择一个或多个音频。
方法二：把音频文件或包含音频的文件夹拖到音频文件列表。
拖入音频文件夹时，当前只读取该文件夹最外层的受支持音频，不会继续扫描更深的子文件夹。
添加后：
每一行前面的复选框表示是否选中该音频用于背景音乐。
单击播放按钮可以试听；再次单击停止。
单击移除按钮只从插件列表移除，不会删除磁盘文件。
单击“清空”清空音频列表，不会删除音频文件。
只有“添加到列表”还不够；开启背景音乐时，还必须勾选至少一首音频。
3. 加入背景音乐
开启后，插件在 PowerPoint 导出和倍速处理完成后，把选中的音频合并到最终 MP4。
只勾选 1 首：本批次所有视频都使用这一首。
勾选多首：每处理一个视频时随机选择其中一首，不能指定一一对应关系。
音频比视频短：自动循环。
音频比视频长：按视频时长截断。
如果打开了“加入背景音乐”但没有勾选任何音频，界面会提示，并在本次任务中跳过背景音乐。
4. 静音PPT原音频
这里的“原音频”是 PowerPoint 导出到视频中的旁白、嵌入音频等。
两个音频开关的组合结果：
静音和背景音乐都需要 FFmpeg。PowerPoint 能否导出某种特殊嵌入音频，也取决于 PowerPoint 自身。
5. 音频列表每页条数
列表底部可以选择每页显示 10、20、50 或 100 首音频。这个设置只影响界面显示，不改变音频处理方式。
七、完整操作步骤
下面是一套适合首次使用者的稳妥流程。
第一步：备份和整理
复制一份重要 PPT 作为备份。
把准备转换的文件放到同一个总文件夹。
如果按项目分了子文件夹，决定是否开启“包含子文件夹”。
建立一个单独的视频输出文件夹。
第二步：选择源文件夹
回到“操作”标签页。
在“PPT文件夹”一行单击“选择”。
找到源文件夹并确认。
查看文件列表。
文件在子目录中时，开启“包含子文件夹”。
核对“总文件数”。
第三步：选择输出文件夹
在“视频文件夹”一行单击“选择”。
选择一个有足够空间的目录。
确认没有把源文件夹和输出文件夹选反。
第四步：设置视频参数
打开“配置”标签页。
首次使用建议选择 1080p、30 fps、1x、每页5秒。
如果需要静音或背景音乐，按本教程第六部分配置。
加入背景音乐时，确认已经勾选音频，而不只是添加到列表。
第五步：先做一个样例
大批量前建议：
回到“操作”页。
清空列表。
只拖入一个较短的 PPT。
单击“开始转换”。
完成后完整播放 MP4，检查画面、时长、动画、字体和声音。
第六步：开始批量转换
重新选择或加载全部目标文件。
再次核对配置。
单击“开始转换”。
不要同时手动打开正在转换的 PPT。
不要让电脑睡眠，不要拔出存放源文件或输出文件的移动硬盘。
等待所有目标文件显示“已完成”。
八、使用拖拽
1. 拖到文件夹输入区域
把源文件夹拖到“PPT文件夹”输入区域，会设为源文件夹并加载。
把输出文件夹拖到“视频文件夹”输入区域，会设为输出目录。
如果拖入单个文件，插件会尝试使用它所在的文件夹。
2. 拖到PPT文件列表
可以拖入单个或多个 .ppt、.pptx、.pps、.ppsx 文件，也可以拖入文件夹。
重复文件会去重。
是否读取拖入文件夹的子目录，由“包含子文件夹”决定。
尚未选择 PPT 文件夹时，插件会根据拖入文件的公共父目录自动设置。
已选择 PPT 文件夹后，可以加入其他位置的文件。
文件来自不同盘符且无法确定公共父目录时，可能无法加入。
跨文件夹加入文件虽然受支持，但有两个注意点：
这类文件通常按文件名直接输出到视频文件夹根目录，同名文件可能覆盖。
这类文件转换失败时，也可能被移动到当前所选 PPT 文件夹下的“失败”目录。
对重要文件，建议先复制到同一个总文件夹再处理。
九、暂停、继续、取消和离开
暂停
单击“暂停”后，当前正在导出的 PPT 会继续完成，队列在开始下一个文件前停住。PPT 很长时，暂停后仍看到当前进度变化是正常现象。
继续
暂停后单击“继续”，队列继续处理剩余文件。
取消
页面没有单独显示“取消”按钮。任务正在运行或暂停时，单击右上角“返回”，工具箱会显示离开确认。
选择不离开：返回当前插件，任务保持原状态。
确认离开：取消当前转换进程并清空未开始的队列。
取消时，插件会先请求 PowerPoint 安全退出；如果进程迟迟不退出，会终止相关转换进程。未开始的文件会标记“已取消”。
重要提醒：
已经显示“已完成”的 MP4 可以保留。
正在转换时留下的 MP4 可能不完整，不能仅凭文件存在就认为成功。
取消后请播放检查当前输出；不完整文件应手动逐个处理后再重新转换。
因用户取消而中止的当前源文件不会按普通转换失败规则自动移入“失败”文件夹。
离开页面
全部完成后可以直接单击“返回”。任务未完成时，关闭插件、刷新工具箱或退出工具箱都不应被当作“后台继续运行”。
十、输出位置和命名规则
基本规则：
demo.pptx 会生成 demo.mp4。
demo.pps 会生成 demo.mp4。
使用相对子目录加载时，会在输出文件夹中保留子目录。
跨所选源目录单独加入的文件，通常输出到视频文件夹根目录。
开始导出某个文件时，目标位置已有的同名 MP4 会被删除并由新结果替换。
正常完成后，源 PPT 保持原位置不变。
例如：
PPT文件夹：D:\待转换PPT 源文件：D:\待转换PPT\课程一\第一课.pptx 视频文件夹：D:\转换后视频 输出文件：D:\转换后视频\课程一\第一课.mp4
失败文件位置
如果第一课.pptx 转换失败，源文件会被移动到：
D:\待转换PPT\失败\第一课.pptx 如果已有同名文件，可能变为：
D:\待转换PPT\失败\第一课_1.pptx
如何判断结果真正成功
同时满足以下条件才算成功：
插件列表状态为“已完成”。
进度为 100%。
MP4 文件大小大于 0。
视频可以从头播放到结尾。
页面数量、顺序、动画和时长符合预期。
声音符合“静音”和“背景音乐”的开关组合。
不要只看文件夹中出现了 .mp4 就认定转换完成。
十一、具体示例
示例一：普通培训PPT
需求：
一个 20 页的培训 PPT。
日常电脑和电视播放。
保留原旁白。
不加背景音乐。
建议：
分辨率：1080p。
帧率：30 fps。
倍速：1x。
每页停留：5秒。
静音PPT原音频：关闭。
加入背景音乐：关闭。
先转换一个样例，确认 PowerPoint 中已有的旁白和动画计时被正确导出。
示例二：无旁白的产品图片展示
需求：
每页是一张产品图。
希望加入同一首背景音乐。
操作：
选择 1080p、30 fps、1x。
每页停留设置为5至8秒。
在音频列表中添加一首 .mp3。
勾选这首音乐。
开启“加入背景音乐”。
如果不希望出现 PPT 原音频，开启“静音PPT原音频”。
转换一个样例，检查音乐音量和总时长。
音乐会自动循环或截断到视频长度。
示例三：多个PPT随机使用不同音乐
添加多首受支持的音频。
勾选准备参与随机选择的音乐。
开启“加入背景音乐”。
开始批量转换。
每个视频会从勾选项中随机选一首。插件不保证顺序，也不提供“某个PPT固定对应某首音乐”的设置。
示例四：需要快速浏览
可以先使用：
720p或1080p。
30 fps。
1.25x或1.5x。
每页3秒。
倍速会改变原音频语速。正式交付前必须完整试听。
十二、常见问题与解决办法
1. 提示无法启动Microsoft PowerPoint
检查：
是否安装桌面版 Microsoft PowerPoint 2013 或以上版本。
能否手动启动 PowerPoint。
Office 是否正在修复、更新或等待首次激活。
当前 Windows 账号能否正常使用 PowerPoint。
必要时先手动打开 PowerPoint，完成首次启动、登录或激活提示，再关闭并重试。
2. 选择文件夹后没有加载文件
检查扩展名是否为 .ppt、.pptx、.pps 或 .ppsx。文件在子文件夹中时，请开启“包含子文件夹”。“失败”文件夹会被故意跳过。
3. 开始按钮是灰色
文件列表为空或已有任务运行。选择 PPT 文件夹并单击“加载文件”，确认列表中出现文件。
4. 提示缺少FFmpeg
当前配置启用了倍速、静音或背景音乐。可以：
将倍速改回 1x，并关闭静音和背景音乐后做基础导出。
更新或重新安装插件及其资源。
仍有问题时联系技术支持。
5. 开启背景音乐后没有音乐
检查：
音频是否已经添加到列表。
是否勾选了音频行前面的复选框。
“加入背景音乐”是否开启。
音频文件是否仍在原路径，是否被移动或删除。
音频格式是否受支持。
如果开关已开启但一首也没勾选，本次任务会提示并跳过背景音乐。
6. 成品没有PPT原音频
检查“静音PPT原音频”是否开启。关闭后仍无声音时，请先在 PowerPoint 中手动“导出/创建视频”测试；某些链接音频、特殊媒体或不受支持的编码可能无法由 PowerPoint 导出。
7. 成品同时有旁白和背景音乐
这是“静音PPT原音频”关闭且“加入背景音乐”开启时的实际效果。只要背景音乐时，请开启“静音PPT原音频”后重新转换。
8. 暂停后当前PPT还在转换
暂停针对队列，不会强行破坏当前 PowerPoint 导出。当前文件完成后才停止开始下一条。
9. 转换非常慢
可能原因：
使用 1440p 或 4K。
使用 50/60 fps。
PPT 页数多、动画复杂或嵌入了视频。
开启倍速，需要再次编码。
开启背景音乐或静音，需要后处理。
磁盘速度慢或剩余空间不足。
可先用 720p或1080p、30 fps、1x 测试。
10. 动画、字体或版式与原文件不同
插件使用本机 PowerPoint 导出，结果取决于本机已安装字体、Office版本和媒体资源。请安装缺失字体、确保链接资源可访问，并用同一台电脑手动播放源 PPT 对比。
11. 文件显示失败后，源PPT不见了
请到所选 PPT 文件夹下的“失败”目录查找。转换失败会自动移动源文件，并在重名时添加数字后缀。
12. 旧MP4被替换
同名输出会被覆盖。正式批量前请选择新的输出文件夹，或先备份已有视频。
13. 取消后留下一个无法播放的MP4
取消可能发生在 PowerPoint 正在写入视频时。只有状态为“已完成”的文件才可信。请逐个删除或移走不完整的输出，再重新转换对应源文件。
14. 两个文件生成了同名视频
跨文件夹单独加入同名 PPT 时，可能都映射到输出根目录的同名 MP4。请把源文件整理到同一总目录并使用不同子文件夹，或先修改文件名。
十三、数据安全与使用注意
插件在本机调用 PowerPoint 和 FFmpeg 处理文件，不会由该转换功能上传 PPT、视频或背景音乐内容。
正常完成不会修改源 PPT；转换失败会移动源 PPT 到“失败”文件夹。
同名 MP4 会被覆盖，开始前请备份。
PPT、旁白、客户资料和成品视频可能包含敏感内容，请保存在受控目录。
背景音乐必须具有合法使用权。向客户公开或商业发布前，请确认音乐版权和授权范围。
不要在任务运行时强制关机、拔移动硬盘或断开网络磁盘。
不要把“出现MP4文件”当作完成标志，必须结合“已完成”状态并完整播放检查。
多首背景音乐是随机选择，要求固定配对时应拆成单独批次，每批只勾选一首。
十四、完成前检查清单
转换前：
电脑是 Windows，并已安装可正常使用的 Microsoft PowerPoint 2013或以上版本。
源文件格式是 .ppt、.pptx、.pps 或 .ppsx。
源文件已备份，并能手动正常打开。
已确认是否需要“包含子文件夹”。
已选择正确的PPT文件夹和视频文件夹。
输出目录中的同名MP4已经备份。
已确认分辨率、帧率、倍速和每页停留时间。
使用静音、倍速或背景音乐时，FFmpeg资源可用。
开启背景音乐时，已经添加并勾选音频。
已理解失败源文件会移动到“失败”文件夹。
已先转换一个样例并完整播放。
转换后：
所有目标文件都显示“已完成”和100%。
成功数量与计划转换数量一致。
输出目录中存在对应的MP4。
子文件夹结构符合预期。
每个重要视频都能从头播放到结尾。
页面顺序、动画、字体和画面比例正确。
视频时长符合每页计时和倍速预期。
原音频、静音和背景音乐组合正确。
已检查“失败”文件夹，并处理失败源文件。
成品视频和音乐版权符合交付要求。
评论区