大牛直播录像SDK

在实时音视频系统中，录像不仅仅是“把音视频写入文件”，还涉及音视频同步、时间戳处理、网络抖动下的缓冲管理、分段文件边界控制以及异常情况下的文件完整性保障。

大牛直播SDK（SmartMediaKit）录像模块采用独立实例设计，与 RTMP 推流、RTSP/RTMP 播放、RTSP 转 RTMP 推送、轻量级 RTSP 服务、GB28181 设备接入等模块解耦，可按需挂载在不同媒体链路中。无论是推流端同步录像、播放端边播边录、多路转发独立存档，还是国标设备接入后的本地录像，都可以通过统一接口灵活集成。

录像模块不依赖某一个具体业务模块运行，上游推流、播放、转发状态变化，不会直接影响录像实例的独立管理能力，适合构建稳定、可靠、可持续运行的音视频录像系统。

目前，该模块已广泛应用于安防监控存档、在线教育回放、工业过程记录、无人机巡检留痕、移动执法取证、应急指挥回溯等场景，支持 Windows、Linux、Android、iOS、鸿蒙NEXT 等平台。

技术架构：

大牛直播SDK录像模块采用“独立录像实例 + 多模块挂载 + 统一文件管理 + 事件回调”的架构设计。

通过独立挂载方式，开发者可以在不改变原有推流、播放、转发、国标接入逻辑的前提下，快速增加录像能力，降低系统耦合度，提升录像稳定性和可维护性。

核心能力

1. 灵活挂载，独立运行

支持与 RTMP 推流端、RTSP/RTMP 播放端、RTSP 转 RTMP 推送模块、轻量级 RTSP 服务、多路转发模块、GB28181 设备接入模块组合使用。

典型场景包括：

RTMP 推流端同步录像；
RTSP/RTMP 播放端边播边录；
RTSP 转 RTMP 推送过程同步存档；
多路转发独立录像；
轻量级 RTSP 服务分发同时本地录像；
GB28181 设备接入后录像留存。

录像模块独立运行，可按需开启或停止，不与推流、播放、转发状态强绑定。

2. 录制控制完善

支持录像实时开启、停止、暂停和恢复，便于业务侧根据场景精准控制录制片段。

支持录像过程中切换 URL：配置一致时可续录同一文件，配置变化时自动分割至下一文件，避免不同音视频参数混写导致文件异常。

支持设置单个录像文件大小上限，自动分段存储；支持自定义录像路径；支持纯音频、纯视频、音视频三种录制模式。

3. 编码格式兼容

视频支持 H.264、H.265 录制，支持 RTSP/RTMP H.265 流直接录入 MP4 文件。

音频支持 AAC 录制，并支持 PCMU、PCMA、Speex 等格式自动转 AAC 后写入。

推流端支持外部编码后的 H.264/AAC 数据直接对接录像模块，便于和已有采集、编码、AI 分析或图像处理链路集成。

4. 稳定写入与事件回调

针对网络堵塞、上游抖动、时间戳波动、音视频到达顺序变化等实时流常见问题，录像模块做了专项处理，确保音视频同步写入、文件结构稳定、时间线连续。

从录像开始、新文件创建、文件完成到录像结束，均支持事件回调。业务侧可基于回调实现录像状态展示、文件路径获取、分段文件入库、自动上传、异常告警和多路录像管理。

支持多路并发录像，每路独立实例管理，互不干扰。