一、功能简介
「批量视频加字幕」功能（对应处理模式：videoAddSrt），可快速批量为视频烧录字幕，支持可选外置音频匹配，最终统一导出为mp4格式成品视频，高效解决多视频字幕添加需求。
核心作用
- 扫描指定文件夹内的视频文件，自动匹配对应.srt字幕
- 按设置的字幕样式（字体、大小、颜色等），将字幕直接烧录到视频画面（硬字幕）
- 可选匹配外置音频，支持替换、混合或移除原视频音频
- 批量导出新的mp4视频，自动规避文件覆盖风险
适用场景
- 已准备好.srt字幕文件，需批量烧录到对应视频
- 视频目录中已放置与视频同名的.srt旁路字幕
- 加字幕的同时，需替换、混合或移除原视频音频
- 需统一导出成品视频，便于发布或二次剪辑
格式支持
| 类型 | 支持格式 |
| 输入视频 | .mp4、.mov、.m4v、.mkv、.avi、.wmv、.flv、.ts、.m2ts、.webm、.3gp、.3g2、.mpg、.mpeg、.mxf、.ogv |
| 字幕 | .srt（唯一支持格式） |
| 外置音频 | .mp3、.wav、.m4a、.aac、.flac、.ogg、.opus、.wma |
| 输出视频 | .mp4（唯一输出格式） |
重要注意事项
- 未匹配到字幕的视频，会被自动跳过，不中断批量处理
- 输出目录不能与源视频目录相同，避免覆盖原文件
- 输出目录存在同名文件时，程序会自动追加后缀（如_2、_3），防止覆盖
- 开启「隐藏源视频音频」但未匹配到外置音频，输出视频会为静音
二、基本使用步骤（新手必看）
- 打开「批量视频加字幕」功能界面
- 输入卡密（软件授权必填）
- 选择「视频文件夹路径」（待处理视频所在目录）
- （可选）如需添加外置音频，选择「音频文件夹路径」
- （可选）如需单独提供字幕池，选择「字幕文件夹路径」
- 选择「生成视频路径」（成品保存目录，不可与源目录相同）
- 设置基础参数：输出命名、音频码率、隐藏源视频音频、最多生成视频数
- 调整字幕样式：字体、位置、字号、颜色
- 点击「保存配置」（避免参数丢失）
- 点击「运行程序」，开始批量处理
- 在「软件日志」区域，查看处理进度、跳过原因及生成结果
三、新手默认配置（推荐起步）
首次使用建议先按以下参数测试（适配大多数场景），确认效果后再批量处理全部素材：
- 最多生成视频数（quantity）：100
- 输出命名（outNameType）：indexAndSourceName（序号+原文件名，便于对应）
- 音频码率（audioBitrate）：128k（音质与文件体积平衡）
- 隐藏源视频音频（hiddenAudio）：false（保留原音频，降低测试风险）
- 运行前清空文件夹（clear）：true（适合反复测试）
- 字幕字体（subtitleFont）：AaHouDiHei-2（内置字体，效果稳定）
- 字幕字号（subtitleFontSize）：8（适中，可按需微调）
- 字幕颜色（subtitleColor）：#fcca00（高亮黄，醒目易读）
- 字幕位置（subtitlePosition）：10（底部居中，适配多数短视频）
测试建议：先选取2-5个视频试跑，确认字幕样式、音频效果无误后，再批量处理全部素材。
四、界面参数详细说明
4.1 基础参数
- 卡密：软件授权唯一凭证，必填项，无有效卡密无法运行
- 视频文件夹路径：待处理视频所在目录，程序会自动扫描该目录下所有支持格式的视频
- 音频文件夹路径：可选，不填写则不匹配外置音频，仅保留原视频音频（适合只加字幕场景）
- 音频随机排序：仅对音频池回退分配生效；开启后，未匹配到同名字音频时，随机分配音频池中的音频；关闭则按文件夹顺序分配
- 字幕文件夹路径：可选，不填写则优先匹配视频同目录下的同名字幕；填写后，将该目录下的.srt作为字幕池参与匹配
- 字幕随机排序：仅对字幕池回退分配生效；开启后，未匹配到同名字幕时，随机分配字幕池中的字幕；关闭则按文件夹顺序分配
- 生成视频路径：成品mp4保存目录，不可与源视频目录相同，避免覆盖原文件
- 运行前清空文件夹内视频：开启后，运行前会删除输出目录中的所有常见格式视频（不删除非视频文件），适合反复测试同一批素材
- 输出命名：控制成品视频文件名规则（详细说明见下文）
- 音频码率：控制输出视频的音频质量，可选64k、96k、128k、160k、192k、256k、320k（详细说明见下文）
- 隐藏源视频音频：开启后不保留原视频音频；匹配到外置音频则仅用外置音频，未匹配则输出静音视频
- 最多生成视频数：控制本次成功生成的成品上限（1-1000），跳过的视频不计入，直到达到设定值或处理完所有源视频
4.2 输出命名说明
假设源视频：旅行记录.mp4，本次生成序号3，批次时间：20260413183025，不同命名方式效果如下：
| 命名方式 | 输出文件名 | 适用场景 |
| index | 003.mp4 | 看重统一排序，无需对应原文件 |
| indexAndTime | 003-20260413183025.mp4 | 需要区分批次，避免重名 |
| sourceName | 旅行记录.mp4 | 只想保留原文件名 |
| indexAndSourceName | 003-旅行记录.mp4 | 推荐，便于对应原文件和排序 |
| timeAndIndex | 20260413183025-003.mp4 | 批次优先，需区分不同处理批次 |
| sourceNameAndIndex | 旅行记录-003.mp4 | 原文件名优先，需补充序号 |
| sourceNameTimeAndIndex | 旅行记录-20260413183025-003.mp4 | 需详细区分批次和序号 |
补充：输出目录存在同名文件时，程序会自动追加后缀（如旅行记录_2.mp4），避免覆盖。
4.3 字幕匹配规则
字幕按以下优先级匹配，未匹配到则跳过该视频（不中断批量处理）：
- 视频同目录下的同名字幕（如D:\素材\视频\001.srt 对应 D:\素材\视频\001.mp4）
- 字幕文件夹中的同名字幕（如字幕文件夹\001.srt）
- 字幕池回退分配（按顺序或随机，取决于「字幕随机排序」设置）
4.4 音频匹配与处理规则
（1）音频匹配优先级
配置外置音频后，按以下顺序匹配，优先使用与视频对应的音频：
- 视频同目录下的同名字音频（如001.mp3 对应 001.mp4）
- 音频文件夹中的同名字音频
- 音频池回退分配（按顺序或随机，取决于「音频随机排序」设置）
（2）音频输出逻辑
- 有外置音频 + 源视频有音频 + 隐藏源音频=false → 原音频+外置音频混合
- 有外置音频 + 隐藏源音频=true → 仅使用外置音频
- 无外置音频 + 源视频有音频 + 隐藏源音频=false → 保留原音频
- 无外置音频 + 隐藏源音频=true → 静音输出
- 源视频无音频 + 无外置音频 → 静音输出
（3）使用建议
- 仅加字幕、保留原音：不填音频文件夹，隐藏源音频=false
- 替换原音（用外置配音）：填写音频文件夹，隐藏源音频=true
- 原音+背景音乐：填写音频文件夹，隐藏源音频=false
提醒：外置音频时长建议与视频时长匹配，避免成品时长受影响。
4.5 音频码率说明
| 码率 | 特点 | 适用场景 |
| 64k | 文件最小，音质较低 | 测试、内部预览 |
| 96k | 音质优于64k，文件较小 | 对音质要求不高的场景 |
| 128k | 音质与体积平衡（推荐默认） | 大多数常规发布场景 |
| 160k/192k | 音质较好 | 正常发布、对音质有一定要求 |
| 256k/320k | 音质最高，文件较大 | 对听感保留要求高的场景 |
新手建议：直接使用128k，无需额外调整。
4.6 字幕样式参数说明
- 字幕字体：控制字幕显示字体，优先使用内置字体，避免跨设备效果不一致
- 对齐方式：支持9个常用位置（底部左/中/右、顶部左/中/右、中间左/中/右）；推荐短视频用底部居中，若被平台文案遮挡，可改为中间居中
- 字体大小：数值越大，字幕越大；建议先小批量测试，根据视频分辨率和观看场景微调（避免遮挡画面或看不清）
- 字体颜色：默认#fcca00（高亮黄）；普通视频可用醒目颜色（白、黄），画面偏亮时可选用更深颜色
五、输出规则说明
- 一个源视频最多生成一个成品视频，不拆分视频，统一输出为mp4格式
- 字幕为硬字幕，直接写入视频画面，后续无法单独关闭（区别于外挂字幕）
- 文件重名保护：输出目录有同名文件时，自动追加后缀（_2、_3等），不覆盖已有文件
- 输出目录预清理：开启「运行前清空文件夹内视频」后，程序会先删除输出目录中的视频文件，再生成新视频
六、常见使用场景及配置建议
| 场景 | 适用情况 | 配置建议 |
| 场景1：视频旁有同名字幕 | 每个视频都有对应.srt字幕，无需单独维护字幕池 | 仅填「视频文件夹路径」，字幕文件夹留空；隐藏源音频=false |
| 场景2：统一字幕池分配 | 视频与字幕非一一对应，需从字幕池轮流分配 | 填写「字幕文件夹路径」；需打乱分配则开启「字幕随机排序」 |
| 场景3：替换原视频声音 | 不需要原视频音频，需替换为外置配音/背景音 | 填写「音频文件夹路径」；隐藏源音频=true |
| 场景4：保留原声+叠加背景音乐 | 需保留原视频声音，同时混入外置音频 | 填写「音频文件夹路径」；隐藏源音频=false |
七、常见问题（FAQ）
1. 部分视频未生成，是什么原因？
常见原因：未匹配到字幕文件、视频损坏无法探测、处理失败；建议查看「软件日志」获取具体提示。
2. 输出视频没有声音，怎么办？
大概率是开启了「隐藏源视频音频」，但未匹配到外置音频；或源视频本身无音频。可关闭「隐藏源视频音频」，或补充外置音频。
3. 为什么输出目录不能和源视频目录相同？
为避免成品视频与原视频混淆，同时防止重名覆盖原文件，程序会直接阻止该配置，需选择不同目录。
4. 设置了生成数量，最终未达到，为什么？
「最多生成视频数」是成功生成的上限，若中途有视频因无字幕、损坏、处理失败被跳过，最终生成数量会小于设定值。
5. 输出文件名多了_2、_3后缀，是什么情况？
这是程序的防覆盖机制，说明输出目录已存在同名文件，程序自动改名保存，无需手动操作。
6. 字幕位置、大小不合适，如何调整？
不同视频分辨率、画面留白不同，建议先拿1-2个视频测试，微调「对齐方式」「字体大小」，确认效果后再批量处理。
八、使用建议（重点）
- 首次使用务必小批量测试（2-5个视频），避免全量处理出现问题
- 视频已自带同名字幕时，字幕文件夹可留空，减少配置步骤
- 重视文件对应关系，优先选择「indexAndSourceName」命名方式
九、问题咨询
使用过程中有疑问，可添加哈皮微信咨询：hapi360
