终极指南：BililiveRecorder配置文件V1/V2/V3版本对比与最佳实践

终极指南：BililiveRecorder配置文件V1/V2/V3版本对比与最佳实践

【免费下载链接】BililiveRecorder录播姬 | mikufans 生放送录制项目地址: https://gitcode.com/gh_mirrors/bi/BililiveRecorder

BililiveRecorder（录播姬）是一款强大的生放送录制工具，其配置文件经历了V1、V2到V3的演进。本文将深入对比三个版本的核心差异，帮助你快速掌握最佳配置实践，轻松实现高效直播录制。

一、配置文件版本演进 overview 📊

1.1 V1版本：基础功能实现（已过时）

V1版本是BililiveRecorder的早期配置格式，采用扁平化结构设计，所有配置项直接定义在根对象中。从BililiveRecorder.Core/Config/V1/ConfigV1.cs源码可以看出，该版本主要包含：

• 房间列表管理（RoomList）
• 基础录制参数（如自动切割模式、时长设置）
• 弹幕录制选项（是否记录弹幕、礼物、SuperChat等）
• 文件名格式设置（record_filename_format）

V1版本使用Newtonsoft.Json进行序列化，所有配置项通过JsonProperty特性直接映射，代码中已标记为[Obsolete]，不建议新用户使用。

1.2 V2版本：初步模块化（已过时）

V2版本在V1基础上引入了模块化设计，从BililiveRecorder.Core/Config/V2/ConfigV2.cs可以看到主要变化：

• 分离全局配置（Global）和房间配置（Rooms）
• 引入继承自ConfigBase的配置基类
• 实现了属性自动映射机制

尽管V2版本解决了V1的结构混乱问题，但代码中同样标记为[Obsolete("Use Config v3")]，已被V3版本取代。

1.3 V3版本：当前推荐版本 ✅

V3版本是目前BililiveRecorder的推荐配置格式，定义在BililiveRecorder.Core/Config/V3/ConfigV3.cs，主要改进包括：

• 完善的模块化结构（Global + Rooms）
• 实现IFileNameConfig接口，统一文件名配置
• 支持CLI模式下的配置路径覆盖（ConfigPathOverride）
• 优化的属性继承与重写机制

二、核心配置项对比分析 🔍

2.1 结构设计差异

2.2 关键配置项变化

工作目录配置

• V1：无专门配置项，依赖程序默认路径
• V2：通过Global.WorkDirectory配置，定义在GlobalConfig类
• V3：同样使用Global.WorkDirectory，但实现了IFileNameConfig接口，提供更灵活的路径处理

录制文件名格式

• V1：直接定义record_filename_format和clip_filename_format字符串
• V2/V3：通过IFileNameConfig接口标准化，支持更多模板变量和继承机制

弹幕录制配置

• V1：提供详细的布尔开关（如record_danmaku、record_danmaku_sc等）
• V2/V3：重构为更结构化的配置方式，便于扩展和维护

三、升级与迁移最佳实践 🚀

3.1 从V1升级到V3

1. 结构转换：将V1的扁平配置拆分为Global和Rooms两部分
2. 参数映射：
   • 全局参数（如Cookie、API地址）迁移到Global配置
   • 房间相关配置迁移到Rooms数组中的对应对象
3. 格式调整：更新文件名模板语法，支持V3新增的模板变量

3.2 从V2升级到V3

V2到V3的迁移相对简单，主要是：

• 确认所有V2配置项在V3中的对应位置
• 检查是否使用了已废弃的配置项
• 更新配置文件版本号为3

3.3 配置文件位置

• 默认位置：程序运行目录下的config.json
• 自定义路径：可通过CLI参数--config指定，对应V3的ConfigPathOverride属性

四、常用配置示例 💡

4.1 基础全局配置（V3）

{ "global": { "workDirectory": "./recordings", "recordDanmaku": true, "cuttingMode": "Size", "cuttingNumber": 2048, "timingCheckInterval": 300 }, "rooms": [] }

4.2 房间配置示例（V3）

{ "rooms": [ { "roomId": 12345, "name": "我的直播间", "recordMode": "Always", "filenameFormat": "{roomid}-{name}/{date}/{title}-{start_time}.flv", "qn": 10000 } ] }

五、配置文件验证与工具 🛠️

BililiveRecorder提供了配置文件验证工具，可通过以下方式使用：

1. 使用CLI命令验证配置：

dotnet run --project BililiveRecorder.Cli -- configure validate

2. 配置文件 schema 验证：
   • V2版本：configV2.schema.json
   • V3版本：configV3.schema.json

六、常见问题解决 ❓

Q: 配置文件修改后不生效怎么办？

A: 确认配置文件版本号与程序版本匹配，修改后需重启录播姬生效。V3版本支持运行时动态加载部分配置。

Q: 如何实现不同房间使用不同的录制参数？

A: 在V2/V3版本中，可在Rooms数组中为每个房间单独设置配置，未设置的参数将继承Global配置。

Q: 配置文件损坏或丢失如何恢复？

A: 可删除现有配置文件，重启程序将生成默认配置。建议定期备份config.json文件。

通过本文的对比分析，相信你已经对BililiveRecorder的配置文件演进有了全面了解。选择V3版本，利用其模块化结构和强大功能，将为你的直播录制工作带来更高效的体验！

【免费下载链接】BililiveRecorder录播姬 | mikufans 生放送录制项目地址: https://gitcode.com/gh_mirrors/bi/BililiveRecorder