实战指南：基于插件化架构的跨平台直播录制系统深度解析

实战指南基于插件化架构的跨平台直播录制系统深度解析【免费下载链接】LiveAutoRecord基于 Electron 的多平台直播自动录制软件项目地址: https://gitcode.com/GitHub_Trending/li/LiveAutoRecord你是否经常因为错过心爱主播的直播而遗憾是否曾为手动录制多个直播平台而烦恼LiveAutoRecord 提供了一个基于现代 TypeScript 技术栈的解决方案通过插件化架构实现了对 B站、斗鱼、虎牙、抖音等主流直播平台的全自动录制支持。本文将深入解析其技术实现、实战应用和二次开发技巧。多场景应用架构设计LiveAutoRecord 采用模块化设计提供了三种不同的使用方式满足不同用户群体的需求桌面客户端应用基于 Electron 构建的桌面应用程序整合了 HTTP Server 和 Web 前端为普通用户提供图形化操作界面。该方案适合个人用户在本地环境中使用支持 Windows、macOS 和 Linux 系统。LiveAutoRecord 桌面客户端主界面采用卡片式布局展示所有录制频道状态服务器端部署通过autorecord/http-server包提供 REST API 和 SSE 实时推送服务配合独立的 Web 前端可在服务器环境中部署实现远程管理和多用户访问。这种架构适合需要 24 小时不间断录制的专业用户。命令行工具autorecord/cli提供了完整的命令行接口支持脚本自动化集成和 AI Agent 交互。对于需要在无 GUI 环境中运行或需要与其他系统集成的场景CLI 工具提供了最大的灵活性。技术栈架构项目采用 pnpm Workspaces Turborepo 管理 11 个独立包每个包都有明确的职责边界。核心调度引擎autorecord/manager作为基础各直播平台插件实现统一的RecorderProvider接口上层应用通过组合不同的插件实现功能。核心录制机制深度解析插件化架构设计LiveAutoRecord 的核心设计理念是插件化。每个直播平台对应一个独立的 npm 包实现标准的RecorderProvider接口interface RecorderProviderE extends AnyObject { id: string; // 唯一标识符 name: string; // 平台显示名称 siteURL: string; // 平台网站地址 matchURL: (channelURL: string) boolean; resolveChannelInfoFromURL: (channelURL: string) PromiseChannelInfo | null; createRecorder: (opts: RecorderCreateOptsE) RecorderE; fromJSON: T extends SerializedRecorderE(json: T) RecorderE; setFFMPEGOutputArgs: (args: string[]) void; }这种设计使得新平台的接入变得非常简单只需要实现上述接口即可。当前已支持的插件包括autorecord/bilibili-recorder、autorecord/douyu-recorder、autorecord/huya-recorder和autorecord/douyin-recorder。录制器状态机设计每个录制器实例都遵循明确的状态流转机制空闲状态 (idle)录制器等待检查直播状态录制中 (recording)直播检测成功后启动 FFmpeg 录制停止中 (stopping-record)收到停止信号正在结束录制过程返回空闲 (idle)录制完全停止准备下一次检查状态转换通过事件驱动录制器通过 mitt 库实现事件系统发射RecordStart、RecordStop、Updated、Message、DebugLog等事件上层应用可以监听这些事件实现实时状态更新。流选择与画质控制录制器支持灵活的流选择和画质配置画质选择 (quality)支持从低到高的多种清晰度设置如 low、medium、high、highest流优先级 (streamPriorities)用户可以指定优先使用的视频流类型源优先级 (sourcePriorities)指定 CDN 源的优先级顺序添加新频道时的详细配置界面支持画质、流优先级和源优先级设置流选择算法遵循以下优先级顺序如果配置了streamPriorities按优先级顺序尝试否则根据quality配置使用 flex-space-between 算法映射到平台的可用画质列表对 CDN 源同样按sourcePriorities配置选择实战应用从安装到高级配置快速安装与启动项目采用 monorepo 结构使用 pnpm 作为包管理器# 克隆仓库 git clone https://gitcode.com/GitHub_Trending/li/LiveAutoRecord cd LiveAutoRecord # 安装依赖 pnpm install # 开发模式启动 Electron 客户端 pnpm app:dev # 构建生产版本 pnpm app:build频道管理与录制配置添加新频道时系统会自动识别直播平台并解析频道信息URL 匹配通过正则表达式匹配域名确定对应的平台插件信息解析调用平台 API 获取频道 ID、标题和主播信息参数配置设置录制画质、存储路径规则等选项自动检测启用后系统会定期检查直播状态并自动开始录制存储路径模板支持使用变量动态生成文件路径如{platform}/{owner}/{title}_{date}_{time}.mp4其中{platform}直播平台名称{owner}主播名称{title}直播标题{date}、{time}录制开始时间录制流程技术实现录制过程的核心逻辑在checkLiveStatusAndRecord方法中实现async function checkLiveStatusAndRecord({ getSavePath }) { // 1. 防重入检查 if (this.recordHandle ! null) return this.recordHandle; // 2. 直播状态检测 const { living, owner, title } await getInfo(this.channelId); if (!living) return null; // 3. 获取直播流地址 const { currentStream: stream, sources, streams } await getStream({ channelId: this.channelId, quality: this.quality, streamPriorities: this.streamPriorities, sourcePriorities: this.sourcePriorities, }); // 4. 准备保存路径 const savePath getSavePath({ owner, title }); const extraDataSavePath replaceExtName(savePath, .json); // 5. 启动 FFmpeg 录制 const command createFFMPEGBuilder() .input(stream.url) .addInputOptions(-user_agent, Mozilla/5.0 ...) .outputOptions(ffmpegOutputOptions) .output(savePath); // 6. 弹幕收集可选 if (!this.disableProvideCommentsWhenRecording) { // 启动弹幕客户端并处理消息 } // 7. 构建录制句柄并返回 return this.recordHandle; }错误处理与容错机制系统实现了多层次的错误处理防重入保护通过singleton包装确保同一时间只有一个录制任务运行流有效性检测监控 FFmpeg 输出检测帧数停滞或 404 错误超时机制10 秒无新数据视为连接断开自动停止录制优雅退出使用 SIGINT 信号终止 FFmpeg 进程确保文件完整性高级功能与自定义扩展弹幕与礼物收集录制过程中可以实时收集弹幕和礼物信息这些数据会同时通过事件系统实时推送到上层应用保存到与视频文件同名的 JSON 元数据文件中可用于后续生成 SRT 字幕文件录制历史界面支持播放录制内容和生成 SRT 字幕文件鉴权系统设计对于需要登录才能获取高画质流的平台如 B站系统实现了完整的鉴权流程// 鉴权字段声明 authFields: [ { key: cookie, label: Cookie, type: textarea, placeholder: SESSDATAxxx; bili_jctxxx; DedeUserIDxxx; ..., description: 从浏览器获取 B站登录 Cookie用于获取原画等高画质直播流, }, ], // 浏览器自动登录流程 authFlow: { loginURL: https://passport.bilibili.com/login, checkLoginResult({ cookies }) { // 从 cookies 中提取鉴权信息 }, timeout: 300_000, // 5分钟超时 },鉴权配置在 Provider 级别共享所有同平台的录制器使用同一份凭据。系统支持通过浏览器窗口自动登录或手动输入 Cookie 两种方式。自定义插件开发指南开发新的直播平台插件需要遵循以下步骤创建包结构在packages/目录下创建新的平台包实现 Provider 接口定义平台 ID、URL 匹配规则、频道信息解析等实现录制逻辑实现checkLiveStatusAndRecord方法处理直播检测和录制流程注册插件在 HTTP Server 和 CLI 的 manager 初始化代码中添加新插件添加依赖更新相关包的package.json文件关键设计要点使用singleton包装核心录制方法防止重复执行通过 Proxy 拦截属性变化自动触发Updated事件实现无效流检测和超时检测确保录制稳定性正确处理 FFmpeg 进程的生命周期管理全局配置与系统设置全局设置界面支持配置自动录制规则、通知设置和应用行为系统提供了丰富的全局配置选项自动检查间隔控制直播状态检测频率录制超时设置定义无数据时的超时时间通知配置录制开始/结束时的系统通知托盘行为关闭窗口时是否最小化到系统托盘FFmpeg 参数自定义视频编码和容器格式参数性能优化与最佳实践内存与资源管理录制器实例化每个频道对应一个录制器实例按需创建和销毁FFmpeg 进程管理使用 child_process 管理确保异常时正确清理弹幕连接复用同一平台的多个频道共享 WebSocket 连接池数据库优化使用 lowdb 进行轻量级数据存储避免过度序列化多线程检查机制对于大量频道的场景系统实现了多线程检查机制// 将频道分组到多个线程中并行检查 const threadCount Math.min(channels.length, maxThreadCount); const chunkSize Math.ceil(channels.length / threadCount); for (let i 0; i threadCount; i) { const chunk channels.slice(i * chunkSize, (i 1) * chunkSize); // 在独立线程中执行检查 }这种设计可以在不阻塞主线程的情况下同时检查多个频道的直播状态显著提高了大规模频道管理的效率。存储策略与文件管理路径模板系统支持变量替换的灵活文件命名元数据分离录制信息保存在独立的 JSON 文件中自动清理可配置保留策略自动删除旧录制文件格式兼容性默认使用 fMP4 格式平衡了抗损坏能力和实时查看需求常见问题排查与调试技巧录制失败诊断当录制失败时可以按照以下步骤排查检查网络连接确认可以访问目标直播平台验证频道状态使用resolve命令检查频道信息解析查看日志输出启用 DebugLog 事件监听查看详细的 FFmpeg 输出测试流地址手动尝试访问获取到的流地址检查鉴权状态对于需要登录的平台验证 Cookie 是否有效性能问题优化如果遇到性能问题可以考虑以下调整调整检查间隔减少不必要频繁的直播状态检查优化线程数量根据 CPU 核心数调整并发检查线程数限制同时录制数避免同时录制过多频道导致带宽或 CPU 过载使用硬件加速配置 FFmpeg 使用 GPU 编码如果可用开发调试技巧开发新插件或调试问题时使用 CLI 工具测试lar resolve URL验证频道解析启用详细日志设置环境变量DEBUGautorecord:*模拟录制测试使用测试流地址避免影响真实直播检查事件流监听 Recorder 的所有事件了解内部状态变化技术架构演进与未来展望当前架构优势插件化设计新平台接入成本低代码复用率高多运行时支持同一套核心代码支持 CLI、Server、Electron 三种运行方式实时事件系统基于 mitt 的事件驱动架构状态变化实时通知原子化操作使用 Steno 确保 JSON 文件写入的原子性潜在改进方向数据库升级考虑使用 SQLite 替代 lowdb 以支持更复杂查询分布式部署支持多节点协同录制提高系统可用性云存储集成直接录制到云存储服务避免本地存储限制AI 增强功能基于录制内容自动生成摘要或精彩片段内置播放器支持直接预览录制内容提供完整的播放控制功能结语构建你自己的直播录制系统LiveAutoRecord 不仅是一个开箱即用的直播录制工具更是一个优秀的技术学习案例。通过研究其源码你可以学习到现代 TypeScript 项目架构pnpm Workspaces Turborepo 的最佳实践插件化系统设计如何设计可扩展的插件接口多进程/多线程编程Node.js 中的并发处理模式事件驱动架构基于 mitt 的松耦合组件通信跨平台开发Electron、CLI、HTTP Server 的统一代码库无论你是需要录制特定直播内容的普通用户还是希望学习现代 TypeScript 项目架构的开发者LiveAutoRecord 都提供了丰富的学习资源和实践机会。通过理解其内部机制你不仅可以更好地使用这个工具还可以基于其架构构建自己的媒体处理系统。项目采用 LGPL 许可证开源鼓励社区贡献和二次开发。如果你对某个直播平台有特殊需求或者希望添加新的功能特性欢迎参考本文档和源码进行扩展开发。【免费下载链接】LiveAutoRecord基于 Electron 的多平台直播自动录制软件项目地址: https://gitcode.com/GitHub_Trending/li/LiveAutoRecord创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考