RELEASE NOTES · DESKTOP SIMULATOR
UVP-28181-SIM-DESKTOP 升级日志
当前版本 1.2.1。各平台安装包、体积与 SHA-256 校验值以下载页为准。
1.2.1
SIP 点播信令修复（2026-11-10）。这一版只修「平台点播后画面一闪就没」的问题，Windows 与 macOS 同时生效；界面与操作方式和 1.2.0 完全一致，从 1.2.0 可直接覆盖安装，设备配置、SIP 参数与压测历史都保留。
- 修复：部分平台点播时刚收到设备的 200 OK 就立刻发 BYE 把流掐掉（紫光华智平台即如此）。原因是设备回「100 Trying」和「200 OK」时各自生成了不同的会话标签，严格的平台会认为最终应答不属于同一次点播；现在同一次点播的所有应答共用同一个标签，符合 SIP 协议规范，并补了自动化用例。
- 修复：200 OK 应答里补上 Contact 地址，平台据此把 ACK / BYE 正确发回设备，此前缺失会让部分平台找不到对话目标。
- 修复：去掉推流前固定等待的 300 毫秒。平台的媒体端口在发起点播之前就已监听，设备发出 200 OK 后现在立刻发起连接，不再因等待错过建流窗口。
- 变更：无新增功能，界面、操作方式与 1.2.0 相同；上述修复两个平台均生效，重新出包只为对齐同一份代码。
本版注意事项
- 建议 1.2.0 用户升级：如果对接的平台在点播时立刻挂断、或点播后始终没有画面，这一版就是针对该问题；若目前点播正常，也可以直接覆盖安装，功能没有变化。
- 未签名状态不变：macOS 包仍未做 Apple 开发者签名与公证，首次打开请右键 →「打开」；Windows 包未做代码签名，首次运行若出现 SmartScreen「未知发布者」，点「更多信息 → 仍要运行」。
1.2.0
压测报告改版（2026-11-09）。这一版把「导出一坨 JSON」换成可以直接发给客户的图表报告，并补上了实测注册速率；顺带修掉 Windows 上几个会直接影响使用的毛病。两个平台均可从 1.1.0 直接覆盖安装，设备配置、SIP 参数与历史记录都保留。
- 新增：压测报告改版——导出的是单文件网页报告，浏览器双击即看。顶部直接给结论（注册成功率、评级、一句话总结），下面是指标卡片、成功率与活跃推流趋势曲线、注册失败归因环形图、心跳比例条；指标明细与压测参数全部翻成中文，认证密码显示为「已隐藏」；图表和样式都打包在文件里，不联网也能打开，浏览器里「打印 → 存为 PDF」就能归档。导出时会弹出「另存为」自己选位置，同目录还会落一份同名
.json保留给机器读取。 - 新增：报告里给出实际注册速率。以前只有设定的爬坡速率，看不出平台实际吃下了多少注册；现在两者并排展示，给出峰值、峰值出现在第几秒和全程均值，并用虚线标出设定值，自动提示「已追平设定 / 被响应速度拖慢 / 明显被阻塞」。配套一张注册速率趋势图，曲线掉下去就表示设备已经注册完、只剩零星重注册。
- 新增：压测运行期间每秒采样一次指标，停止后可回看成功率与推流随时间的走势（最长约 2 小时，超出自动抽稀）。
- 修复：Windows 上点「注册设备」后程序直接退出。首次准备视频文件时一次性占用过多栈内存，进程被系统强制结束，表现是点完注册窗口瞬间消失；现在改为堆上分块处理，内存占用平稳。
- 修复：Windows 屏幕采集抓错显示器。装了向日葵、GameViewer、Citrix 这类虚拟显示器驱动的机器上，显示器编号会顶到十几，之前会报「找不到采集输出」或抓到黑屏；现在按系统真实输出索引选取，匹配不上时会说明原因并在日志里列出可用输出。
- 修复：从摄像头/屏幕切回「视频文件」时被迫重新选文件，现在直接复用上次选中的文件，没有才回落到内置素材。
- 优化：压测快速预设会高亮当前档位，手动改动任意参数后自动取消高亮。
- 修复：报告参数表里平台 ID 在旧配置下显示成「 / 域」，现在按域解析并注明。
本版注意事项
- 报告的曲线只覆盖本次运行：趋势图数据来自本次压测期间的内存采样，关闭应用或重新开始压测后不再保留；多次压测之间的横向对比尚未支持。需要长期留存，请在导出后保存 HTML 或打印成 PDF。
- 平均注册速率会被摊薄：1000 台设备若在 20 秒内拉完，之后全程只剩零星重注册，用全程平均会得到很小的数。判断平台承压能力看峰值更准，均值只作辅助。
- macOS 与 Windows 提示不变：macOS 包仍未做 Apple 开发者签名与公证，首次打开请右键 →「打开」；Windows 包未做代码签名，首次运行若出现 SmartScreen「未知发布者」，点「更多信息 → 仍要运行」。
1.1.0
macOS 摄像头能力补齐（2026-11-09）。这一版改动集中在 macOS 侧，Windows 功能与 1.0.0 相同；两个平台重新出包，与同一份代码对齐。从 1.0.0 可直接覆盖安装，配置与设备数据兼容。
- 新增：macOS 摄像头支持 OSD 烧录——时间戳、自定义文字、斜铺水印、遮挡框可直接烧进实时码流，设置页里配好的 OSD 会对平台侧收到的画面生效，与 Windows 行为一致。
- 新增：macOS 安装包内嵌带 OSD 能力的 FFmpeg，装完即用，不必另外安装运行时。
- 修复：macOS 摄像头画面左右镜像。内置摄像头采集到的是自拍镜像（自己举右手，画面里看起来是左手），推到平台上左右方向与现场相反；现在会在编码前统一翻正，OSD 文字仍按正常方向绘制。
- 修复：macOS 出包脚本把系统自带的 Swift 运行库误判成缺失依赖，导致安装包生成中断。
- 优化：出包脚本修正参数传递方式，Windows 安装包构建不再因参数被拆开而中断。
本版注意事项
- macOS 屏幕录制权限：首次使用屏幕采集时，需到「系统设置 → 隐私与安全性 → 屏幕与系统音频录制」勾选本应用；勾选后必须完全退出应用（Cmd+Q）再重新启动，系统权限只在应用启动时读取。直接从 DMG 挂载盘里双击运行的那份副本不会被授权，请先把应用拖进「应用程序」再从那里启动。
- 外接摄像机：如果接入的外接摄像机画面方向本来就正常，翻正后会变成反向，可用环境变量
UVP_CAMERA_MIRROR=0关闭自动翻正。注意从访达双击启动的应用拿不到终端里的环境变量，需要从终端启动才生效。
1.0.0
首个正式版本（2026-11-08）。从上一个版本至今共 170 次提交，功能与稳定性整体成型，版本号从此以 1.0.0 为基线。Windows 与 macOS 安装包均已内嵌 FFmpeg / ffprobe，装完即用，无需另外安装运行时。
- 新增：报警单管理与报警历史、定时录像周计划与调度、本地抓拍图库与日志导出。
- 新增：设备校时页面（SNTP）、录像缩略图与时间筛选、通知中心、订阅运行详情。
- 新增：云台六字段与硬件版本可配置；视频点播支持 TCP 被动模式、可单独关闭音频；OSD 水印可烧入实时码流。
- 新增：压测预设新增 10000 台档位；业务目录支持 215 / 216 下级平台模板，设备根下可直接新增业务分组与虚拟组织。
- 优化：首页默认不再自动预览，点按钮开启后走 WebCodecs 硬件解码；实时采集优先使用硬件编码器。
- 优化：云台控制整体重构进「模拟器中心」，三维朝向修正为「画面右为正」；采集来源条改版，内置演示视频作为默认媒体源。
- 优化：SIP 接入改用 TCP 共享连接池；视频通道默认名统一为
Uvp-Camera-序号；音视频与设备配置页排版统一。 - 修复：Windows 上定位不到 ffprobe 导致录像功能全部不可用；安装包内缺 ffprobe 与 FFmpeg 依赖 DLL 导致启动后媒体功能不可用。
- 修复：摄像头预览与推流左右镜像、云台按右方向键镜头左摆、订阅卡片未随平台订阅激活。
- 修复：设置页底部内容被裁切且缺垂直滚动条、模拟器中心非全屏下内容裁切、Windows 上 FFmpeg 控制台窗口闪现、正式包残留开发态特性。
安装与首次运行
Windows：从下载页取 x64-setup.exe 双击安装。首次运行可能弹 SmartScreen「Windows 已保护你的电脑 / 未知发布者」，点「更多信息 → 仍要运行」即可。本版安装包未做代码签名，这是预期提示。
macOS：仅支持 Apple Silicon（M1 / M2 / M3 / M4 及更新）。下载 DMG，双击后把应用拖进「应用程序」。本版未做 Apple 开发者签名与公证，首次打开会被系统拦下：到「系统设置 → 隐私与安全性」找到被拦下的 UVP GB28181 Desktop，点「仍要打开」，再双击应用确认一次即可。若提示「已损坏，无法打开」，这是未公证的误报，在终端执行一次即可解除：
xattr -dr com.apple.quarantine "/Applications/UVP GB28181 Desktop.app"首次启动会请求摄像头、麦克风、屏幕录制权限，请全部允许，否则对应功能不可用。
已知限制
- macOS 只提供 arm64 版本，Intel 芯片的 Mac 无法运行；Linux 桌面包暂未在官网提供。
- 两个平台的安装包均未做代码签名 / 公证，首次运行需按上面的步骤放行。
- macOS 若收回屏幕录制权限，需重启应用才能重新生效。