为什么不能只看 RTSP 和 ONVIF
大多数项目可以先用 RTSP 和 ONVIF 完成基础接入,但部分现场会遇到更复杂的需求:厂商私有通道、NVR 远端录像、历史设备兼容、特殊云台控制、事件告警、设备状态、子设备目录或厂商特定回放接口。这个时候就需要评估厂商 SDK 适配。
厂商 SDK 的价值在于补齐标准协议覆盖不到的能力,但它也会带来运行库体积、平台支持、版本兼容、授权和部署依赖。项目上应先确认是否真的需要厂商 SDK,而不是默认把所有设备都走私有接口。能用 RTSP/ONVIF 稳定完成的链路,应优先保持标准协议路径;只有标准协议不能满足录像、控制或兼容需求时,再启用厂商 SDK。
适配时重点验证什么
厂商 SDK 适配应至少验证登录、设备信息、通道列表、实时预览、码流编码、断线恢复、录像检索、回放启动、错误码、日志和多路并发。若涉及 Windows 和 Linux,还要确认运行库、依赖文件、路径、权限和打包方式。
StreamGate 专业版面向这类厂商适配场景,将厂商设备能力收敛到通道管理、预览、录像、回放和开放接口中,减少业务系统直接依赖各厂商 SDK 的成本。
厂商 SDK 适配适合放在专业能力层
海康、大华、宇视、天地伟业等设备通常都支持标准协议,但在远端录像、特殊设备目录、告警事件、历史设备兼容、部分云台能力和厂商平台联动方面,厂商 SDK 仍可能更直接。把这类能力放在专业版或项目交付范围内,有利于控制安装包体积、依赖复杂度和现场验证成本。
标准协议能完成的链路,应优先使用 RTSP、ONVIF 和 GB28181。只有当项目明确需要标准协议之外的能力,或目标设备在标准协议实现上存在兼容差异时,再启用厂商 SDK 适配。这种边界对客户也更清楚:基础接入保持通用,深度能力按目标设备和项目范围验证。
适配不仅是链接运行库
厂商 SDK 适配需要处理登录、会话保持、错误码、字符集、通道枚举、预览启动、断线恢复、录像查询、回放控制、日志路径和运行库依赖。不同厂商在接口命名、回调线程、回放数据方式和平台支持上差异明显,不能只看是否能编译通过。
打包时还要确认 Windows / Linux 的库文件、运行时依赖、授权文件、环境变量、路径和服务权限。若一个项目不需要某个厂商深度能力,运行包也不应强制暴露无关配置。
回放能力要按厂商单独确认
厂商远端录像回放通常有两种形态:一种是返回可播放或可转发的媒体流,另一种是通过 SDK 回调数据流。前者更容易接入网关的播放分发链路;后者需要产品层把回调数据重新封装并接入回放管线。若厂商 SDK 不提供某些回放控制能力,例如倍速、暂停或精确拖动,应在产品中做明确降级。
验收建议
项目验收建议至少覆盖真实设备登录、通道列表、实时预览、断线恢复、远端录像检索、回放启动、异常账号、错误密码、设备离线和多通道并发。对需要长期运行的现场,还应进行数小时以上的稳定性观察,并保存日志和版本信息。
