GB/T 28181 · DEVICE SIMULATOR
国标28181 设备模拟器：没有摄像机也能把平台联调跑通
平台刚部署完，手上却没有一台能注册的国标设备；设备在甲方机房，改一个参数要等一天——这是国标项目最常卡住的一步。设备模拟器用软件扮演前端设备，先把注册、心跳、目录、点播这条链路走通，等真机到了只剩品牌兼容要验。
什么时候需要设备模拟器
- 平台刚装好，还没有设备：想确认 SIP 服务、信令端口、注册密码都配对了，不必等采购。
- 设备不在手边：现场设备只能远程操作，先用模拟器在本地复现问题，再决定要不要改现场。
- 要验容量：真买一万台摄像机不现实，用虚拟设备顶上去压平台。
- 要验版本：2016 和 2022 的差异在信令细节里，真机型号覆盖不全，模拟器可以随时切换。
两种形态，解决的不是同一件事
| 形态 | 适合的场景 | 能做什么 | 入口 |
|---|---|---|---|
| 移动端（Android） | 现场随手验证，一台手机就是一台设备 | 注册、心跳、实时点播、录像回放、设备控制、结构化信令日志 | 移动端模拟器下载 |
| 桌面端（Windows / macOS） | 单机联调 + 批量压测 | 上面全部，外加最多 10000 台虚拟设备并发、爬坡速率与推流占比可配、SIP 报文逐条可查、报告导出 | 桌面端模拟器下载 |
iOS 版本还在确认发布渠道，下载页会显示当前状态；Android 安装包已经可以直接扫码装。
跑通一轮，只有四步
- 平台侧建一条设备，拿到四个参数：SIP 服务器 ID（20 位国标编码）、SIP 域、服务器 IP、SIP 端口，外加注册密码。
- 模拟器里填同样四个参数，再填本机的 20 位设备编码（前 10 位等于域，第 11–13 位是设备类型，摄像头用
132）。 - 启动模拟器，平台设备列表里出现这台设备并且状态是「在线」，说明注册成功。
- 在平台点播，模拟器收到 INVITE 后开始推流，平台能看到画面。
四步里任何一步不通，都可以直接看模拟器打印的 SIP 报文定位：是注册被拒（401/403）、还是平台发了 INVITE 但模拟器没回 200、还是回了但媒体没到。这比对着真机猜快得多。
详细的参数含义和五个最常见的卡点，写在没有摄像头怎么把国标平台联调跑通里。
和常见的开源做法差在哪
社区里流传较广的做法是 C++ 命令行工具加一份 XML 配置（比如 EasyDarwin 社区的 GB28181DeviceSimulator）：改一次路数要改 XML 再重启，没有图形界面，只在 Windows 上跑。如果你只需要「一次性拉起几千台，看平台崩不崩」，这类工具够用。
UVP 桌面向模拟器把这些搬进了界面：2016 / 2022 一键切换，内置演示视频、本地文件、摄像头与屏幕采集，SIP 报文逐条可查，压测结果能导出成报告。真正省时间的差别在排错——失败的时候你能看到卡在哪一步，而不是只知道「有 3% 没上来」。
工程上还有两点：MIT 许可证，可以自己改；安装包内嵌 FFmpeg，不用另外装依赖。
常见问题
模拟器能替代真机验收吗
不能。真机验收要验的是品牌兼容、码流封装差异、GB 35114 加密，以及各厂商私有扩展。模拟器解决的是「平台逻辑通不通」，不是「海康这台型号行不行」。
Windows 提示「未知发布者」，macOS 打不开怎么办
两个包都没有做代码签名和公证，这是正常的。Windows 在 SmartScreen 里点「更多信息 → 仍要运行」；macOS 到「系统设置 → 隐私与安全性」点「仍要打开」，或者执行 xattr -dr com.apple.quarantine 去掉隔离属性。完整步骤写在桌面端下载页的说明里。
模拟器会不会被平台当成非法设备
不会。它用的就是标准 GB/T 28181 注册流程，注册密码来自你自己的平台，行为和一台真机一致。
只做联调、不压测，用哪个就够
手机端就够。只有当你要一次拉起几十台以上，或者要看 TPS 和失败分布时，才需要桌面端。