xiangbing/VideoConcat
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
3748c0999b
VideoConcat/docs/快速开始.md
xiangbing a27e2eaaeb feat: update
2026-01-01 15:39:54 +08:00

6.2 KiB
Raw Blame History

VideoConcat 快速开始指南

环境准备

系统要求

  • Windows 10/11 或更高版本
  • .NET 8.0 Runtime（如果未安装，程序会提示下载）

检查环境

# 检查 .NET 版本
dotnet --version

如果未安装 .NET 8.0，请访问 .NET 下载页面 下载安装。

获取项目

方式一：克隆仓库

git clone <repository-url>
cd VideoConcat

方式二：下载源码

下载项目压缩包并解压到本地目录。

编译项目

使用 Visual Studio

  1. 打开 VideoConcat.sln
  2. 选择 Release 或 Debug 配置
  3. 点击"生成" → "生成解决方案" (Ctrl+Shift+B)

使用命令行

# Debug 编译
dotnet build

# Release 编译
dotnet build -c Release

运行项目

方式一：Visual Studio

  1. 按 F5 或点击"启动"按钮
  2. 程序会自动编译并运行

方式二：命令行

# Debug 运行
dotnet run

# 或直接运行可执行文件
.\bin\Debug\net8.0-windows\VideoConcat.exe

方式三：Release 版本

.\bin\Release\net8.0-windows\VideoConcat.exe

功能使用

1. 视频拼接功能

准备工作

准备视频文件，建议的文件夹结构：

视频文件夹/
├── 文件夹1/
│   ├── 视频1.mp4
│   ├── 视频2.mp4
│   └── 视频3.mp4
├── 文件夹2/
│   ├── 视频A.mp4
│   └── 视频B.mp4
└── output/  (自动创建，用于存放输出文件)

操作步骤

  1. 启动程序

    • 运行 VideoConcat.exe

  2. 选择功能

    • 在主界面选择"视频"标签

  3. 选择文件夹

    • 点击"选择文件夹"按钮
    • 选择包含视频子文件夹的目录（不是选择单个视频文件）

  4. 选择拼接模式

    • 组合拼接模式: 从每个文件夹随机选择视频进行组合
      • 例如：文件夹1有3个视频，文件夹2有2个视频
      • 可以生成 3×2=6 种组合
    • 顺序拼接模式: 按索引顺序从每个文件夹选择对应位置的视频
      • 要求所有文件夹的视频数量相同
      • 例如：每个文件夹都有3个视频，会生成3个组合

  5. 设置数量

    • 在"数量"输入框中输入要生成的视频数量
    • 数量不能超过最大可生成数量

  6. （可选）添加审核图片

    • 点击"选择审核图片"按钮
    • 选择要添加为水印的图片文件
    • 图片会叠加在视频底部

  7. 开始拼接

    • 点击"开始拼接"按钮
    • 程序会显示处理进度
    • 完成后在 output 文件夹查看结果

输出结果

  • 输出位置: {选择的文件夹}/output/
  • 文件命名: yyyyMMddHHmmss{随机数}.mp4
  • 如果添加了审核图片，会生成两个文件：
    • 原始拼接文件
    • 带水印的文件（文件名不同）

2. 视频抽帧功能

准备工作

准备要处理的视频文件：

视频文件夹/
├── 视频1.mp4
├── 视频2.mp4
└── 视频3.mp4

操作步骤

  1. 选择功能

    • 在主界面选择"抽帧"标签

  2. 选择文件夹

    • 点击"选择文件夹"按钮
    • 选择包含视频文件的目录

  3. 开始抽帧

    • 点击"开始抽帧"按钮
    • 程序会随机删除每个视频中的一帧
    • 处理完成后在 out 文件夹查看结果

输出结果

  • 输出位置: {选择的文件夹}/out/
  • 文件命名: {随机数}{原文件名}

3. 视频元数据修改功能

操作步骤

  1. 选择功能

    • 在主界面选择"抽帧"标签

  2. 选择文件夹

    • 点击"选择文件夹"按钮
    • 选择包含视频文件的目录

  3. 开始修改

    • 点击"开始修改"按钮
    • 程序会修改视频的元数据（添加注释）
    • 这会改变文件的 MD5 值，但不改变视频内容

输出结果

  • 输出位置: {选择的文件夹}/out/
  • 文件命名: modify{随机数}{原文件名}

常见问题

Q1: 程序无法启动

A: 检查是否安装了 .NET 8.0 Runtime。如果未安装，程序会提示下载链接。

Q2: 视频转换失败

A:

  • 检查视频文件是否损坏
  • 检查视频格式是否支持（主要支持 MP4）
  • 查看日志文件了解详细错误信息

Q3: 拼接后的视频没有声音

A:

  • 检查原始视频是否有音频轨道
  • 某些编码格式可能需要重新编码音频

Q4: 处理速度很慢

A:

  • 视频处理是 CPU 密集型操作，大文件需要较长时间
  • 可以关闭其他占用 CPU 的程序
  • 检查磁盘空间是否充足

Q5: 临时文件占用空间

A:

  • 临时文件存储在系统临时目录
  • 程序处理完成后会自动清理
  • 如果程序异常退出，可能需要手动清理临时文件

Q6: 顺序拼接模式提示错误

A:

  • 确保所有文件夹中的视频数量相同
  • 检查文件夹名称是否正确

Q7: 如何查看日志

A:

  • 日志文件位置: bin/Debug/net8.0-windows/Log/
  • 日志文件命名: log{日期}.log，例如 log20251019.log
  • 使用文本编辑器打开查看

性能优化建议

  1. 使用 SSD 硬盘: 视频处理涉及大量磁盘 I/O，SSD 可以显著提升速度

  2. 关闭杀毒软件实时扫描: 临时文件频繁创建和删除可能触发扫描

  3. 确保足够内存: 建议至少 8GB RAM

  4. 关闭其他程序: 释放 CPU 和内存资源

  5. 批量处理: 一次处理多个文件比逐个处理更高效（程序已实现）

注意事项

  1. 备份重要文件: 虽然程序不会修改原始文件，但建议先备份

  2. 磁盘空间: 确保有足够的磁盘空间存储输出文件和临时文件

  3. 文件路径: 避免使用包含特殊字符的文件路径

  4. 处理时间: 视频处理需要时间，请耐心等待，不要强制关闭程序

  5. HEVC 编码: 抽帧功能会自动将 HEVC 编码转换为 H.264，这需要额外时间

技术支持

如遇到问题，可以：

  1. 查看日志文件了解详细错误信息
  2. 检查视频文件是否正常
  3. 确认系统环境是否符合要求

下一步