5 Commits

Author SHA1 Message Date
liufumingren
0d0b0b8db2 fix(camera): 云台凭据以 rtspUrl 为准 + ISAPI 通道号以设备自报为准
线上实测(69 条指令、5 台相机)暴露两个问题:

1) ONVIF 全部报 "SOAP Fault: Authority failure"
   平台下发的 username/password 字段不可靠:密码含 @ 时它把 @ 切给了 ip 字段
   (下发 ip="@192.168.11.247" + password="qwe2024",而 rtspUrl 里是 admin:qwe2024@…)。
   原来 _parseTarget 让显式字段优先,于是拿着错密码去连 → 认证失败(4 台全挂)。
   改为凭据以 rtspUrl 解析结果为准,显式字段只在 rtspUrl 缺项时兜底
   (ip / channel / port 仍以上层下发为准)。

2) 海康 IPC 直连时通道号错了 → 403
   平台从 rtspUrl 的 /streamN 推出来的 channel 是它自己的相机编号。实测 192.168.8.165
   (海康 DS-2XD8F826E 双目 IPC)只有 PTZ 通道 1,发通道 6 直接 403。
   新增:枚举 GET /ISAPI/PTZCtrl/channels,以设备自报通道为准(下发编号在列表里就用它,
   否则用第一个);枚举不到(如 NVR 不支持该接口)则沿用原推导逻辑;结果按 host 缓存。

3) 顺带:无云台机构的摄像机给出明确原因
   同一台 8.165 的 panSupport/tiltSupport/zoomSupport 全是 false(没有云台机构),
   发通道 1 设备会回 200 但什么也不动(属假成功)。现在直接返回
   "该摄像机没有云台机构,已跳过发送",避免日志里出现误导性的成功。

另:上一版试验过的"ISAPI 二次确认"(要求 deviceInfo 返回 <DeviceInfo>)已撤除——
实测未发现 ISAPI 误判(8.165 本就是真海康),而它会把权限受限/返回体不含 DeviceInfo
的真海康设备误判成 ONVIF。

真机复验:11.247 用平台那条"错密码"报文 → ONVIF 认证通过并成功转向(凭据修复生效);
8.165 → 明确报无云台机构,不再 403。离线回归 42 断言全通过(新增通道回退 / 无云台 4 条)。
2026-09-15 22:13:58 +08:00
liufumingren
8fa511dfa1 feat(camera): 云台支持 ONVIF,兼容非海康设备(实测 TP-Link 可动)
背景:平台下发的 camera.ptz.* 目标实测是 TP-Link TL-IPC682P-A4(192.168.9.226 /
192.168.11.247),设备没有 ISAPI(/ISAPI/System/deviceInfo 404,PUT 返回 405 +
{"error_code":-10000} 的 JSON),纯 ISAPI 实现必然全失败(线上 20 条指令 0 成功)。

- 协议选路:先探海康 ISAPI(_isapiProbe),不通则走 ONVIF;结果按 host 缓存,
  不会每条指令都多一次探测往返
- ONVIF 实现:continuousMove(方向用 onlySendPanTilt、变倍用 onlySendZoom,
  速度档 1~7 → 0.15~1)/ stop / gotoPreset / setPreset;
  聚焦、光圈、autoPan 在 ONVIF 下无对应接口,明确返回不支持(而不是静默失败)
- 新增 ONVIF_MOVE_TIMEOUT_MS=30s 兜底:ONVIF 的 ContinuousMove 不带 Timeout 时
  设备会一直转,服务端漏发 stop 就停不下来;设 0 可关闭以与 ISAPI 行为完全一致
- 预置点:契约里的 presetId 先按 token 匹配、再按 Preset{id} / preset_{id} 名字匹配;
  setPreset 优先指定 token,设备不接受时让它自行分配并把实际 token 写进日志
- 平台下发的 ip 字段实测是 "@192.168.11.247"(多一个前导 @),新增 _cleanHost
  统一清洗,并兼容误传完整 rtsp:// 的情况
- utils/cameraOsd.js 导出 _isapiProbe 并支持自定义 port(默认 80,原调用行为不变)

真机实测(192.168.11.247,与生产同一台):协议探测 → ONVIF,会话 profileToken=profile_1,
left 1 秒后位置 x 由 0.6766 → 0.5717(Δx=0.1049,方向正确),设备预置点 token 1~8。
离线回归 38 断言仍全通过。
2026-09-15 22:03:22 +08:00
liufumingren
13872b0514 feat(camera): 云台优先使用服务端下发的 ip/账号密码/通道
- cameraPtz#_parseTarget(rtspUrl, opts) 改为优先使用 opts 的 ip/username/password/channel/port
  (rtspUrl 仅作兜底,解析失败不再报错)
- services/camera.js 把 data.ip / data.username / data.password 透传给 cameraPtz
2026-09-15 21:57:50 +08:00
liufumingren
5258a84bee fix(camera): 云台/OSD 日志目录改用 getAppDataDir(),修复 Linux 下落到字面量目录
cameraPtz.js/cameraOsd.js 自己用 process.env.ProgramData || SystemDrive/ProgramData 拼日志目录,非 Windows 上两者都为空 → path.join('C:','ProgramData') 变成相对路径,在 9.101 上实际写到 /opt/printserver/C:/ProgramData/printServer/*.log(cameraOsd 自 7/30 起如此)。

改用项目既有约定 utils/runtime.js#getAppDataDir()(frpc.js 同款):Windows 打包版仍为 %ProgramData%\\printServer(与文档一致),Linux/开发态为项目根目录,与 frpc.log/run.log 同级。
2026-09-15 19:05:57 +08:00
liufumingren
68d84351a5 feat(camera): 云台 PTZ WS 下发(ISAPI),修复预置点路径缓存串号与 port 透传
服务端(services.printer 中转)下发 camera.ptz.control/stop/presetGoto/presetSet/auto,客户端走海康 ISAPI 执行,路径与报文对齐官方无插件 SDK(webVideoCtrl.js)。

- utils/cameraPtz.js 新增:动作表/别名/SDK 索引、速度换算(<7 档 ×15,≥7 档 100,停止=0)、候选路径回退与缓存、Digest/Basic 自适应、独立 cameraPtz.log

- services/camera.js 新增 ptz 服务;这些方法一律不返回值,避免 wsClient 回显被服务端当成一次服务调用(服务路径 camera 不存在)

- utils/cameraOsd.js 导出 extractRTSPInfo/_isapiAuth/_isapiRequest 并给后两者加可选 port(默认 80,行为不变)

- 修复:路径缓存原来存整条 URI,预置点 URI 带 presetId,goto(3) 之后 goto(5) 会先命中 presets/3 调错预置点 → 改为缓存候选序号,presetGoto/presetSet 分键

- 修复:presetGoto/presetSet/auto 漏传 opts.port,非 80 端口设备这三个动作永远失败

- 修复:日志 _writeLog 只 join 参数,%s 占位符被原样写入日志 → 改用 util.format(cameraOsd/cameraPtz)
2026-09-15 19:03:12 +08:00