NVR 接入不只是增加一路视频源
很多现场已经部署了 NVR，网关接入时可能面对两类需求：一类是把 NVR 的实时通道取出来做浏览器观看和业务系统对接，另一类是检索 NVR 或网关本地录像并提供回放。两类需求的验收方式不同，不能只用实时预览代替录像回放验收。
实时接入重点看通道列表、RTSP 地址、认证方式、主码流/子码流、H.264/H.265、断线恢复和多画面性能。录像回放重点看录像来源、时间索引、通道过滤、拖动定位、倍速能力、回放地址、磁盘保留策略和权限控制。若使用本地录像，还需要确认录像目录、文件切片、索引生成、磁盘空间预警和清理策略。
本地录像和远端录像要分清
本地录像由网关自己保存和索引，更容易统一检索与回放。远端录像依赖 NVR 或厂商 SDK 能力，不同厂商在检索粒度、回放控制和流输出方式上可能不同。项目设计时应先明确“录像存在哪里”，再确认回放入口放在 StreamGate Web Console、业务系统，还是第三方平台。
对正式项目，建议至少准备一段真实设备录像，验证跨小时检索、跨天检索、拖动、断流后的索引连续性和浏览器播放兼容性。
录像检索应以时间和通道为核心
录像回放页面的核心不是展示文件列表，而是让用户快速回答“某个时间、某个通道有没有录像，能不能立即播放”。因此检索条件应优先围绕时间范围、通道、录像来源和事件类型组织。结果列表建议突出开始时间、结束时间、通道名称、录像来源、时长和可播放状态，便于值守人员快速定位。
对 NVR 接入场景，录像可能存放在 NVR、厂商平台或 StreamGate 本地。不同来源的索引粒度、查询速度和回放能力可能不同。界面和接口应清楚区分本地录像和远端录像，避免用户误以为所有回放能力完全一致。
拖动、倍速和首帧时间要单独验收
录像能播放不代表回放体验已经合格。现场常用操作包括按时间跳转、拖动进度、暂停、恢复、倍速、切换通道和跨天查询。每个操作都可能触发新的媒体请求或索引查询，必须观察首帧时间、错误提示、播放状态和日志记录。
对于远端 NVR 或厂商 SDK 回放，如果底层不支持某些控制能力，应在页面或接口中明确降级，而不是提供不可用按钮。对于本地录像，重点要保证索引生成、文件切片和回放地址之间一致。
存储容量和保留策略要提前计算
录像容量与通道数、码率、录制时长、保留天数和音频有关。一个 4Mbps 的视频流连续录像一天大约需要 43GB 左右空间，实际还要考虑封装开销和索引文件。项目部署前应按目标通道数和保留天数估算磁盘容量，并确认磁盘预警、自动清理和异常断电后的索引恢复策略。
接口对接时关注一致性
如果业务系统需要通过 API 查询录像或打开回放，接口返回的通道 ID、时间范围、播放地址和错误码应与 Web Console 一致。这样现场人员在页面上看到的问题，业务系统也能通过日志和接口定位，而不是形成两套口径。