常见问题解答与错误码查询

描述约定

1）本机：运行客户端软件的电脑。

2）设备：Tofu系列设备。

3）相机：成像识别一体化Tofu设备或网络相机。

常见问题解答

1. 程序运行报错

序号	检查项	是/否
1	弹窗报错“找不到VCOP*****.DLL”，这表明电脑中缺少基本的Windows相关库。 请到TVMS安装路径下双击安装VC2019_redistrib.x64.exe。 通常情况下，电脑中会自带此库，如果未报错则无需再次安装。

2. 设备登陆失败、无法搜索、升级失败、异常掉线问题

序号	检查项	是/否
1	如果是点对点直连，请检查本机IP地址是否为固定IP，并确保其网段与设备一致。 若网段不一致或使用路由访问，需要手动添加设备。 必要时关闭系统局域网防火墙。 安装软件后windows系统若提示是否允许软件访问网络，此时应允许访问。 若选了不允许，则需要重装一下软件。
2	检查本机是否Ping通设备与相机，键盘win+R，输入cmd， 输入ping 192.168.1.200（默认IP地址）， 若您已修改IP，则使用设备实际IP地址，确认网络链接是否正确。
3	设备如果存在多个网卡，设备搜索中“选择网卡”对应网卡是否是同一网段的网卡。
4	本机IP地址是否与设备IP在同一网段，网关是否正确，本机IP地址不能与网关地址相同。
5	是否存在IP冲突，即同网段是否有其他设备拥有一样的IP。
6	虚拟机网络是否禁用，虚拟机占用同一网段可能导致设备无法搜索。
7	如果您忘记了设备IP地址，请参考第12节《忘记IP地址》重新检查当前设备IP地址。
8	部分杀毒软件会截获升级包，此时需要禁用杀毒软件。
9	查看“窗口信息”处的信息显示，如有报错误代码，请查看错误码查询表。
10	手动添加的设备确认是否选择厂家为“AI-Camera”， 厂家选“Camera”只能浏览视频，无法控制。
11	请勿在升级包名称中带有特殊字符、括号、空格、中文等内容。

3. 无视频数据（绿幕或蓝幕）

序号	检查项	是/否
1	检查视频源相机的配置，确保其压缩格式为H.264且帧率为25fps，视频传输协议为RTSP。 请在视频输入接口汇总 核对是否符合视频输入格式要求。
2	用VLC检查视频拉流地址是否正确。
3	检查相机拉流地址、用户名、密码是否正确。 参考RTSP地址格式：rtsp://UserName:Password@ip:554/... 输入拉流地址时，如果存在乱码、中文符号或空格，可能会导致拉流失败。 实际视频拉流地址请咨询相机厂家。
4	相机Onvif鉴权是否关闭，一般相机网页中有设置。
5	检查本机防火墙UDP通信是否开启，建议关闭防火墙。
6	相机与设备是否处于同一网段，同时没有IP冲突。
7	如果偶尔出现绿幕，请检查网络线缆、交换机、网络相机等设备。 这通常是由于无法稳定获取视频导致的现象。 您可以在Onvif Device Manager软件中打开“Application settings”配置菜单， 开启“Show video playback statistics”来查看当前实际帧率。 如果解码帧率（decoding fps）降至20帧以下， 通常是由于网络链路不稳定或IP地址冲突导致的。

Onvif Device Manager (ODM) 是onvif协议视频浏览操控工具，请自行搜索下载。

4. 系统升级异常

序号	检查项	是/否
1	检查系统升级文件名是否存在汉字、汉字括号等不支持标识。
2	检查本机防火墙是否关闭或允许客户端透过防火墙上传与下载数据包。
3	客户端是否以管理员权限启动。C盘安装的客户端部分系统下会要求管理员运行。
4	升级版本是否高于设备中的软件版本，升级只能单向进行。
5	禁用虚拟机网络，可能导致了网络搜索区域不对，卸载/禁用某些杀毒软件。
6	多网卡电脑在升级时会弹出窗口，请选择对应的网卡进行升级。

5. 云台控制失灵

序号	检查项	是/否
1	检查云台地址码是否正确，默认云台地址为01。
2	设备RS485线是否松动，线序是否正确。
3	检查云台波特率是否为9600bps。
4	是否有多台设备同时占用云台总线，这会导致发送的指令无法被接收。

6. 镜头变焦控制失灵

序号	检查项	是/否
1	变焦相机与设备之间的UART或RS232电平是否匹配。
2	变焦相机与设备间的RXD, TXD是否交叉连接。
3	变焦相机接口协议是否是标准的VISCA协议。
4	变焦相机接口波特率是否是9600bps。

7. 红外图像整体为灰色/黑色

序号	检查项	是/否
1	检查热红外相机是否开启了灼伤保护模式，这会导致快门自动遮挡。
2	热红外机芯挡片是否处于遮挡状态，可以在客户端打开光圈。

8. 设置工作模式异常

序号	检查项	是/否
1	检查是否是以管理员用户身份登录客户端。
2	设备版本号过低，可升级设备与SDK版本，使用高版本客户端。

9. 目标无识别

序号	检查项	是/否
1	目标识别功能是否已开启，通过打开OSD查看模型是否与目标类型匹配。
2	目标识别类型是否开启，参数设置中打开AI OSD查看打开的识别类型与模型是否对应。 例如无人机识别模型，只支持无人机目标。
3	目标是否过大，软件中限制了大于画面高/宽的50%为误报。
4	是否存在识别围界区域，并且区域设置在画面视场不可见的区域。 可点击“清除围栏”，删除所有设置区域。

10. 目标有识别不跟踪

序号	检查项	是/否
1	识别是否稳定，只有在连续三帧稳定识别后，才能切换为跟踪模式。
2	识别目标是否在画面边界上，太靠近画面边界或超出画面边界目标不会切换为跟踪。
3	是否存在围界区域，或者围界区域在画面视场内不可见的位置，此时跟踪不会启动。 只有区域内的识别物体才会切换到跟踪。 可以点击“清除围栏”，删除所有设置区域。

11. 图像卡顿

序号	检查项	是/否
1	检查相机输出帧率是否为25Hz，帧率过低可能会导致设备推流卡顿。
2	网络是否稳定，检查交换板的带宽是否足够，用2.7中的方法进行验证。
3	多设备时检查电脑CPU/GPU占用率，电脑解码能力不够将导致视频出现马赛克。
4	检查局域网内是否有IP冲突，如果点对点连接，请将电脑IP设置为同网段固定IP。
5	检查内部线缆是否有松动，导致网络连接不稳定。

12. 忘记IP地址

如果忘记设备IP地址且无法在客户端搜索到设备，可以将设备与电脑直连，使用Wireshark抓包工具监听ARP协议。ARP请求发起的非本机设备即为对应设备。请自行搜索并下载该工具。

13. 无目标截图

序号	检查项	是/否
1	检查截图发送功能是否已开启，JSON截图需要发送开启指令。
2	检查数据是否被防火墙屏蔽或运行程序的权限不够。

14. 客户端报错“设备厂家不支持”

TVMS添加设备使用手动添加模式时请将设备厂家类型改为“AI-Camera”并保存，重新添加到视频窗口中。
默认的厂家“Camera”仅支持视频浏览。
详见TVMS使用说明： https://littro.helplook.net/docs/TVMS#2.2.1_设备添加

---