故障排查

切换台无法连接

• 确认这台电脑能 ping 通切换台的 IP，且两者处于同一局域网。
• 确认切换台一侧已开启相应功能和端口：vMix 电脑的防火墙已放行 TCP 8099；OBS Studio 已开启 WebSocket 服务器；Panasonic AV-HS410 已安装 HS410_IF 插件；Roland VR Series 的 TCP 8023 可以连通。
• 查看控制台「切换台」页显示的错误提示，例如「OBS Studio 密码不对」「端口被占用，换一个接收端口」。
• 查看服务日志：macOS 位于 ~/Library/Logs/iTally/server.log，Windows 位于 %LOCALAPPDATA%\iTally\Logs\server.log，Linux 位于 ~/.local/state/iTally/server.log。

TSL 或 Grass Valley 收不到数据

• 切换台的输出需指向「切换台」页显示的「电脑地址 : 端口」，且两端的 UDP / TCP 设置一致。
• 系统弹出防火墙提示时，请选择允许。
• 端口被其他程序占用时，页面会给出提示。更换接收端口，或关闭占用端口的程序后，连接会自动恢复。

手机无法打开或持续显示黄色

• 手机和电脑需处于同一局域网。部分场地的 Wi-Fi 会隔离设备，可尝试更换网络。
• 在「手机扫码」页为「电脑地址」选择正确的网卡。候选地址中可能包含 Docker 等虚拟网卡，请选择与切换台、手机同一网段的地址。
• 显示黄色时，屏幕上会注明原因：「切换台没连上」，请参阅「切换台无法连接」；「找不到画面」，表示该机位在当前切换台下未选择对应画面，或所选画面在切换台上不存在；「机位已删除」，表示该机位已在控制台中删除。

颜色与切换台不一致

• TSL UMD V3.1 默认 tally 1 = Program、tally 2 = Preview，部分切换台正好相反，请对照切换台设置。
• Roland VR Series 只报告 PGM，因此 Preview 不会亮；vMix 和 Roland Smart Tally 不会同时报告 Program 和 Preview。
• ATEM 以 M/E 1 的节目输出为准：仅在 M/E 2 上切换、而 M/E 1 未使用 M/E 2 时，不会亮起。

断线后很久才变黄

• TSL 使用 UDP 时无法察觉切换台掉线，会停留在最后的状态。请改用 TCP。
• Vizrt TriCaster 仅在状态变化时推送；如果断电或断网而连接未断开，需要几分钟才会显示 Unknown。

其他电脑无法打开控制台

• 确认启动器窗口中的「其他电脑」开关已打开，且服务正在运行。
• 提示「错太多次」时，请等待 1 分钟后重试。
• 系统弹出防火墙提示时，请选择允许。