Skip to content

hymREC面向虚拟主播直播切片的关键词触发录制

监控直播间,命中关键词或弹幕密度达标时,自动产出含前 90 秒上下文的视频切片

快速开始 ​

环境要求:Go 1.21+、ffmpeg(加入 PATH)。

bash
git clone https://github.com/Maicarons/hymREC.git
cd hymREC

make build
cp config.example.yaml config.yaml   # 修改 room_id
./bin/hymREC -c config.yaml

产物目录:recordings/(触发录制产出的切片)、video_buffer/(持续分段缓冲,自动清理)。

工作原理 ​

B站流 → 视频环形缓冲(ffmpeg TS分段) ──触发时回溯前90秒──▶ 录制控制器 ──▶ 切片输出
  └──▶ 音频采集(ffmpeg PCM) → VAD → 环形缓冲 → ASR → 关键词检测 ──触发──┘
  └──▶ 弹幕监听(WebSocket) → 密度统计 ──延迟确认──触发──────────────────┘
环节机制
触发ASR 命中 T1–T4 关键词,或弹幕密度 30 秒窗口 ≥ 5 条并通过延迟确认
回溯触发时从视频缓冲取 [触发前 90 秒, 停止时刻] 的分段,ffmpeg concat 合并
续期录制期间再次命中关键词(或弹幕)会刷新停止倒计时,继续录制
停止最后一次触发后静默 stop_delay_seconds(默认 120 秒)自动合并输出切片

切片长度 = ring_buffer_seconds 回溯时长 + 最后一次触发后的持续时长,而非固定 90 秒切一段。

文档与论文 ​

免责声明

本项目仅供学习交流使用。请在征得对方许可的情况下录制,勿用于商业用途或大规模录制,详见法律声明。

AGPL-3.0 License · 仅供学习交流