QSV转FLV (Rust移植版)

简介

一个简单的命令行工具，可以将爱奇艺qsv格式的视频转换为flv格式

这是学习Rust后的第一个项目，感谢原C#项目作者提供的针对QSV的解决方案，也欢迎大家fork或提交PR，帮助完善功能或修复bug

本程序仅支持QSV v2.0（可能无法处理某些较早的视频，例如部分16年前的视频）

之前用爱奇艺看电视时，想收藏一些影视资源，于是去网上找相关的转码工具。遗憾的是，有些工具要么骗钱，要么不好用卡顿错帧。后来发现了一些不错的能够转换QSV的代码，但总觉得他们的实现有些仓促，于是用Rust重写，并做出了改进

Rust的开发体验确实不错，解决了很多C++的痛点，同时又可以较大程度保证运行性能

使用方法

命令行运行 （最近实现了交叉编译，提供了多种系统平台下已编译好的程序）

qsv2flv 0.1.1
ZhangZhilin <corex_public@outlook.com>
A tool for converting QSV to FLV

USAGE:
    qsv2flv [FLAGS] <INPUT> <OUTPUT>

FLAGS:
    -h, --help       Prints help information
    -V, --version    Prints version information
    -v, --verbose    Print test information verbosely

ARGS:
    <INPUT>     Sets the input file to use
    <OUTPUT>    Sets the output file to use

功能特性

• 仅供学习用途（切勿将该项目用于非法盈利）

• 提供了简单的命令行前端交互

• 转换速度快

  • 在SSD硬盘下：效率大约是C#版本的2倍，与另一个由C++复刻的实现接近
  • 在HDD硬盘下：有时能快于C++复刻实现的2倍
  • 该结果是在Windows平台（后端为msvc）下试验得到的，也许LLVM后端可能会有更好的性能表现

• 不会生成临时文件

  • 减少固态不必要的写寿命损耗
  • 在读写相对较慢的HDD上，快于C++复刻的版本，部分情况下转码速度可达2倍
  • 实现思路的性能瓶颈主要是相对更频繁的随机seek操作

设计细节

执行顺序：

// 将QSV转换为FLV
fn convert_qsv_to_flv(qsv: &mut File, flv: &mut File) -> Result<()>
    /* [步骤] 检查QSV文件是否正确 */
    // 验证QSV格式
    fn validate_qsv_format(qsv: &mut File) -> Result<()>

    /* [步骤] 解析QSV文件中 */
    // 从QSV中解析得到每个TAG块的信息
    fn tag_blocks_from_qsv(qsv: &mut File) -> io::Result<FlvTagBlocks>
        // 将QSV文件seek至QSV的TAGS的起始处
        fn seek_qsv_to_start(qsv: &mut File) -> io::Result<()>
        // 使QSV文件的seek指针跳过元数据开头
        fn skip_qsv_metadata(qsv: &mut File) -> io::Result<()>
    // 从所有TAG块获取FLV的元数据
    fn meta_data_from_tag_blocks(qsv: &mut File, tags: &[FlvTagBlock]) -> Result<MetaData>
        // 解析视频TAG块信息 (是否为关键帧, 视频编码ID)
        fn parse_video_tag(qsv: &mut File, tag: FlvTagBlock) -> Result<(bool, u8)>
        // 解析音频TAG块信息 (音频编码ID, 音频采样率, 音频采样大小, 音频是否为立体声)
        fn parse_audio_tag(qsv: &mut File, tag: FlvTagBlock) -> Result<(u8, u8, u8, bool)>
        // 从TAG块中读取时间戳
        fn get_time_stamp_from_tag(qsv: &mut File, tag: &FlvTagBlock) -> Result<i32>

    /* [步骤] 正在写入到FLV文件中 */
    // 根据已提取出的TAG块信息和FLV元数据，将QSV转换为FLV
    fn write_from_qsv_to_flv(qsv: &mut File, tags: &[FlvTagBlock], flv: &mut File, meta: &MetaData)
        -> Result<()>

错误类型：

pub enum ErrorKind {
    Io(std::io::Error),      // 文件系统IO错误
    IncorrectQsvVersion,     // 错误的QSV版本：本程序无法处理
    IncorrectQsvFormat,      // 错误的QSV格式：不符合预期格式/该文件不是QSV
    QsvTagsIsEmpty,          // 该QSV文件TAG块数量小于1个
    MediaDurationIsTooShort, // 媒体时长过短
}

计划事项

计划任务

• 检查输出路径是否已存在文件，询问覆盖，防止因File::create(...)导致意外覆盖

• 性能探查：valgrind, qcachegrind

• trait FilePlus {
      fn read_byte(&mut self) -> std::io::Result<Option<u8>>;
      fn write_byte(&mut self, u8) -> io::Result<bool>;
      fn tell(&mut self) -> std::io::Result<u64>;
  }
  impl FilePlus for File {
      //...
  }
  

• 性能优化：unsafe优化

• 详细进度显示

• 确保宿主机跨平台可移植性：跨系统、大小端、32位/64位

• 完善注释、文档

计划特性

• 支持管道输出/重定向输出
• 改进FLV生成，提供更多可设定的FLV元数据参数（建议引入：flavors && nom）
• 支持批量文件转码

性能测试

简单测试样例：

文件名称	文件大小	存储介质	本项目[Rust]用时	其他版[C++]用时
iPartment 5第2集-蓝光1080P.qsv	842MB	2.5英寸希捷机械	34.095s	65.914s
iPartment 5第1集-蓝光1080P.qsv	895MB	2.5英寸Intel固态	14.048s	13.537s
Smooth Criminal.qsv	18MB	2.5英寸Intel固态	0.442s	0.143s

更新记录

• v0.1.0

  • 更新日志

    • 第一个可用版本
    • 避免了临时文件的生成

  • 备注

    • 这是一个命令行程序，没有提供图形界面，但使用方法并不难

• v0.1.1

  • 更新日志

    • 增加了磁盘缓存同步步骤，防止在某些意外情况下可移动磁盘数据丢失
    • 修改了错误处理代码，因为相关代码被新Rust版本标记为 deprecated

• v0.1.2

  • 更新日志

    • 重构了少量代码，改善了代码风格，也因此改动了部分函数签名

  • 备注

    • 该版本代码行为上与v0.1.1一致，主要集中在代码风格、文档的改进
    • 将宏代码分离到单独模块: macros.rs
    • 提供了多种平台的编译结果