SoftControl 使用手册

明确自己当前是“日常使用者”还是“系统配置者”。

1. 如果你只负责日常开馆、闭馆、播放控制、灯光控制，请重点阅读第 3 章和第 7 章。
2. 如果你需要新建设备、录入指令、搭建页面、设置定时任务、导入授权，请完整阅读本手册。
3. 如果你同时负责交付和培训，请在操作前准备一份设备地址表和一份项目交接表。

• 你已经知道自己接下来要进入前台界面还是后台管理。
• 你已经准备好设备清单，而不是边做边找设备参数。

• 还没有确认设备参数，就直接进入编辑器开始做页面。
• 把前台操作人员培训成管理员操作，导致现场误改配置。

准备一份可以直接用于录入指令的实施资料。

1. 整理每台设备的名称、品牌、型号、物理位置和控制用途。
2. 记录每台设备使用的控制方式：UDP、TCP、PJLink、串口、WOL、Modbus TCP、Modbus RTU 等。
3. 对于网络设备，记录 IP 地址、端口号、是否需要返回值、是否需要延时执行。
4. 对于串口设备，记录 COM 口、波特率、数据位、停止位和校验方式。
5. 把设备按区域或流程分组，例如“入口区”“大厅区”“投影系统”“灯光系统”“闭馆流程”。

• 你已经能回答每台设备应该如何被控制。
• 你已经能把设备按页面或按流程拆分，而不是全部混在一个页面。

• 建议在 Excel 或表格里维护设备地址表，内容至少包括设备名、协议、地址、端口、备注。
• 如果项目后续需要第三方系统联动，提前约定接口 ID 命名规则。

确认安装环境可用，避免后续把运行问题误判成配置问题。

1. Windows 版先解压安装包，再确认电脑已安装 Visual C++ 运行库；如果启动时报缺少 DLL，先补运行库再继续。
2. Android 版安装 APK 后，第一次启动请允许应用正常完成初始化。
3. 启动系统后，先查看是否能正常进入首页，首页是否能看到“进入系统”和“后台管理”入口。
4. 第一次启动时让系统自动生成默认配置，不要手动删除或替换刚创建的配置目录。
5. 进入系统信息页，确认设备 ID、版本和授权状态已经正常显示。

• 首页显示正常，没有白屏或直接闪退。
• 系统信息页能看到设备 ID，说明授权识别链路正常。

SoftControl 会在配置目录中保存页面、组件、指令和分组数据。首次生成成功后，后续修改都会围绕这些文件进行。

用最小返工成本完成第一个项目。

1. 进入后台管理，先确认语言和授权状态。
2. 先去指令管理页面录入单条设备指令，并逐条测试。
3. 把需要顺序执行的动作整理成指令组，例如“一键开馆”“一键闭馆”。
4. 进入可视化编辑器，新建页面并确定页面名称和背景图。
5. 添加按钮组件和文本组件，把按钮逐个绑定到页面跳转、指令列表或控制组。
6. 保存后进入前台运行界面，逐页测试每个按钮。
7. 确认操作链路稳定后，再设置定时任务和第三方联动。
8. 最后导出配置并做一份交付备份。

• 你已经有一套从命令到底层界面的实施顺序。
• 你不会再出现“页面做好了，但指令没录完”的返工情况。

通过一个最小项目学会完整流程，而不是只学会一半。

1. 首页放“进入系统”“一键开馆”“一键闭馆”“后台管理”几个核心入口。
2. 设备控制页放投影机、主机、播放器等设备的开机 / 关机按钮。
3. 灯光控制页放“全开”“全关”和 1 到 2 个单回路控制按钮。
4. 首页或菜单页再放一个返回按钮，确保页面路径清晰。
5. 每个页面先做功能正确，再补视觉优化。

• 第一次练手时，优先追求按钮真的能控制设备，而不是追求界面复杂和炫。
• 如果一个按钮对应多台设备，优先用指令组，不要手工在多个按钮里重复录入命令。

• 第一次项目就做十几个页面，结果页面多、按钮多、错误也多。
• 还没有完成最小闭环，就开始做复杂背景图和装饰文本。

完成一次安全的开馆流程。

1. 进入系统首页，确认界面没有授权到期提示，也没有明显异常弹窗。
2. 先点击“一键开馆”；如果项目没有做一键开馆，则按页面逐项执行。
3. 如果要手动执行，建议顺序是：主机 -> 投影 -> 播放器 -> 灯光 -> 其他环境设备。
4. 点击按钮后等待设备实际响应，不要连续猛点同一个按钮。
5. 开馆完成后，到每个关键区域确认实际画面、灯光和声音都符合预期。

• 投影设备已经亮机并输出正确画面。
• 需要播放的内容已经启动，灯光状态符合开馆标准。

• 投影还没完全启动就立即切信号或发播放命令。
• 看到设备未立即响应就反复点击，导致同一条命令被多次发送。

完成一次稳定的闭馆流程。

1. 优先停止播放内容或切回待机内容。
2. 关闭灯光或切换到闭馆灯光场景。
3. 关闭投影机，等待投影机进入关闭流程。
4. 最后关闭主机和其他可延后关闭的设备。
5. 如果项目做了“一键闭馆”，执行后仍然要人工确认关键设备都已关闭。

• 播放器已停止或切回默认界面。
• 投影、灯光、主机等设备都已进入闭馆状态。

• 若主机需要正常关机时间，可把主机关闭命令放在流程最后并设置延时。
• 闭馆后建议再巡视一次现场，防止某一路灯或某台投影没有响应。

掌握前台页面的通用操作方式。

1. 页面跳转按钮一般用于“进入某个区域”“返回菜单”“返回首页”。进入后先认清当前页面用途。
2. 播放控制页面常见按钮包括播放、暂停、停止、静音、音量加、音量减，以及内容切换按钮。
3. 灯光控制页面通常分为“全开 / 全关”和单路控制。批量控制用于流程，单路控制用于补调。
4. 每次操作后都观察设备实际状态，而不是只盯着按钮是否被点击。
5. 如按钮没有响应，先等 1 到 3 秒；网络设备和串口设备都可能存在短暂延迟。

• 你能通过页面结构快速找到自己需要的按钮。
• 你知道一次操作后应该看设备、屏幕、灯光或音响哪个结果来判断成功。

前台值班人员不建议进入后台管理，更不建议修改页面、指令或授权。前台人员只负责使用，不负责重新配置。

成功进入后台，并知道常用模块在哪里。

1. 在首页点击“后台管理”按钮。
2. 在弹出的密码框中输入后台密码；默认密码通常为 123，正式项目请尽快修改。
3. 进入后台首页后，先识别几个核心模块：可视化编辑器、指令管理、指令组、定时器、配置管理、授权管理、日志、网络诊断。

• 你已经能正常进入后台首页。
• 你知道后续如果要改页面、改指令、查日志，分别该进哪个模块。

• 在前台运行期间直接进入后台并修改项目，导致现场按钮逻辑与培训内容不一致。
• 项目交付后仍使用默认密码。

完成后台的首次安全初始化。

1. 先进入系统信息或授权管理，确认当前是试用版还是正式版。
2. 如果项目是正式交付，优先导入授权文件，避免做到一半才发现功能受限。
3. 进入语言设置，把界面调整成实施人员和客户都能看懂的语言。
4. 立即修改后台密码，并把新密码记录到项目交接文档。

• 授权状态、设备 ID、版本信息已经确认。
• 后台密码已经不是默认密码。

• 如果现场有多位维护人员，建议统一使用项目密码管理规则，而不是口头传密码。
• 试用版环境也建议先了解限制项，避免误以为是软件故障。

知道什么时候是功能限制，什么时候是真故障。

1. 在授权管理中查看设备 ID，并在需要时复制给供应商申请授权。
2. 获取授权文件后，使用“导入授权文件”功能导入。
3. 导入成功后，再次检查授权状态是否更新，限制功能是否已开放。
4. 如果授权到期，系统可能只允许进入授权管理或系统信息页面，此时先处理授权，不要继续排查页面逻辑。

• 你知道当前项目是否可以使用定时器、配置导出和更完整的编辑能力。
• 你能区分“授权限制”与“配置错误”。

授权到期后，前台运行和定时器可能都会受影响。出现此类问题时，优先检查授权页，而不是先改页面。

录入一条可以被独立测试成功的设备指令。

1. 进入指令管理，点击新增指令。
2. 给指令起一个清楚的名字，建议用“设备名_动作名”的格式。
3. 选择协议类型，例如 UDP、TCP、PJLink、串口、WOL、Modbus TCP 或 Modbus RTU。
4. 填写目标地址：网络协议填写设备 IP，串口协议填写 COM 口。
5. 填写端口号或波特率，确保与设备说明一致。
6. 输入指令文本；如果设备需要特殊格式，请以设备协议文档为准。
7. 根据需要设置延时、超时、重试次数、是否等待响应、响应超时时间和响应编码。
8. 保存后先单独测试这条指令，不要一开始就把它挂到按钮上。

• 单条指令独立执行后，设备能产生正确动作。
• 日志中可以看到对应执行记录。

• 名称写成“按钮1”“开机按钮”，后期根本分不清控制的是哪台设备。
• 设备未测试成功就绑定到页面，结果出问题时不知道是页面错还是指令错。

知道一条指令失败后应该先看什么、后看什么。

1. 先确认设备本身在线、通电并处于可接收控制的状态。
2. 检查协议类型是否选对，例如设备要求 TCP 却选成 UDP。
3. 检查 IP、端口、串口号、波特率是否和设备表一致。
4. 检查指令文本是否有大小写、空格、结束符或十六进制格式错误。
5. 如果设备启动慢，增加延时后再测试后续动作。
6. 查看日志页，确认系统到底有没有真正把命令发出去。
7. 必要时用网络诊断页面验证目标地址是否可达。

• 你能判断问题出在设备连接、协议参数还是页面绑定。
• 你能用日志和网络诊断辅助定位，而不是只靠猜。

• 对于 TCP 指令，如果设备会返回内容，可以开启等待响应，有助于联调。
• 对于需要顺序执行的动作，先保证每条单命令都稳定，再考虑组合。

知道每种能力该放在哪个场景里使用。

1. 当一个按钮需要连续执行多台设备的命令时，创建指令组。
2. 一键开馆、一键闭馆、会议模式、演示模式等都优先用指令组实现。
3. 需要读取 PLC、传感器、状态点位时，进入 Modbus 点位管理进行配置。
4. 需要让 SoftPlayer 或第三方程序触发某个按钮动作时，给组件配置外部接口 ID。

• 你已经知道什么时候建单条命令，什么时候建组。
• 你不会把状态采集、页面按钮和外部接口混成一套逻辑。

外部接口默认使用 UDP 8818 和 TCP 8819。接口 ID 只能使用字母和数字，并且必须保证唯一。

建立一个结构清晰的页面体系。

1. 进入可视化编辑器后，先在左侧页面列表中查看当前已有页面。
2. 点击添加页面，先创建首页、菜单页和各功能页。
3. 页面名称要直接反映用途，例如“首页”“设备控制”“灯光控制”“投影控制”。
4. 选中页面后，在顶部或页面设置区域为该页面选择背景图。
5. 如果没有合适背景，可先用纯逻辑页面完成调试，后面再补背景。

• 你已经能在页面列表中看懂整个项目结构。
• 你能清楚说出每个页面负责什么功能。

• 页面名称写得太抽象，例如“页面1”“控制页2”。
• 还没想好页面层级就开始堆按钮，结果后面大量返工。

在页面上放出清晰、可维护的组件布局。

1. 选中目标页面，在画布上添加组件。
2. 标题、说明、提示语优先使用文本组件。
3. 可操作项统一使用按钮组件，并保持同一类按钮样式一致。
4. 通过拖拽把组件移动到合适位置，再用方向键微调。
5. 如果要快速复制一组相似按钮，使用 Ctrl+C 和 Ctrl+V。

• 页面主次清楚，用户一眼能看出哪里是操作按钮、哪里是说明文本。
• 同类按钮大小和样式保持一致。

• 首页按钮建议少而大，功能页按钮建议按区域或流程分组摆放。
• 常用操作按钮放中间或下半区域，返回按钮放固定位置，减少误触。

让页面里的每个按钮都可预测、可测试、可维护。

1. 选中一个按钮，在属性面板里查看动作设置区域。
2. 如果这是导航按钮，动作选择页面跳转，并指定目标页面。
3. 如果这是提示按钮，动作选择显示文本，并输入说明内容。
4. 如果这是直接控制按钮，动作选择发送指令，并选择对应指令列表。
5. 如果这是流程按钮，如一键开馆，优先选择控制组或已整理好的组逻辑。
6. 每绑定完一个按钮，就在预览模式或前台运行中立即测试。

• 你能说出页面上每个按钮点击后会发生什么。
• 按钮逻辑不依赖记忆，而是通过名称和动作配置一眼可见。

• 按钮文字写“开馆”，结果绑定到错误页面跳转。
• 多个按钮共用相同名字，后面排查时完全分不清。

形成“修改一项、验证一项”的工作习惯。

1. 每完成一个页面的核心按钮后，先点击预览。
2. 预览通过后再保存配置，不要把大量未验证修改一次性堆积。
3. 退出编辑器前，回到前台运行界面完整测试主要流程。
4. 确认无误后再继续下一个页面，或进行配置备份。

• 修改后的页面在前台能按预期使用。
• 离开编辑器前，你已经完成至少一次完整流程测试。

编辑器支持撤销、删除、复制和预览。遇到布局混乱时，先回退到正确状态，再继续修改，不要硬改。

让固定流程自动执行，减少人工重复操作。

1. 进入定时器管理，先查看当前已有任务，避免重复创建。
2. 新建任务时先写清楚任务名称，例如“每日开馆 08:30”“每日闭馆 18:00”。
3. 设置触发时间和触发规则。
4. 执行动作建议优先复用已经验证过的按钮或指令组，不要重新录一套新命令。
5. 创建后先用手动触发功能测试一次，确认流程正确再正式启用。
6. 启用后观察执行历史，确认定时器真的被调度。

• 任务能被手动触发成功。
• 定时器列表里显示为启用状态，并能看到执行历史。

• 定时器直接调用未验证过的新命令，结果自动任务失败却不知道原因。
• 没有先看授权状态，结果误以为定时器故障。

确保项目可以复制、恢复和迁移。

1. 项目完成关键阶段后，立即导出一次配置。
2. 至少保留页面、组件、指令、指令组、组件组和 Modbus 点位配置。
3. 在备用设备或测试环境上尝试导入一次，确认备份可恢复。
4. 如果要在另一台设备上线，先导入配置，再逐项测试网络地址和授权匹配情况。
5. 交付前保存一份“最终验收版”和一份“可回滚版”。

• 你手里有可恢复的配置文件，而不是只有正在运行的现场设备。
• 备份文件已经在另一套环境里验证可用。

• 每次重大改动前先备份一次，可以大幅降低误删和误改风险。
• 配置迁移后最容易出问题的是 IP 地址、串口号和授权绑定，迁移后优先检查这三类。

让项目在交付后依然可维护、可定位、可追溯。

1. 联调阶段保持日志页开启，观察关键按钮执行后是否成功。
2. 如果设备是网络控制，结合网络诊断检查链路是否连通。
3. 把项目中的关键流程整理成交接清单，例如开馆、闭馆、紧急停止、恢复默认状态。
4. 交付时同时提供后台密码、授权状态、设备地址表、配置备份位置和日常操作说明。
5. 培训客户时让对方亲自完成一次开馆和闭馆流程，而不是只看演示。

• 你不仅交付了界面，也交付了维护资料。
• 客户至少知道日志页、网络诊断页和授权页在什么位置。

真正成熟的项目，不是“只有原实施人员会用”，而是“后来接手的人看资料也能接着维护”。

快速判断问题在按钮、指令、设备还是网络。

1. 先看日志页，确认按钮点击后是否有对应执行记录。
2. 如果没有日志，说明问题可能在页面绑定或动作配置。
3. 如果有日志但失败，继续检查指令协议、地址、端口、指令文本和设备状态。
4. 如果设备是网络控制，再看网络诊断，确认目标地址可达。
5. 如果设备是串口控制，确认串口号没有被系统或其他程序占用。

• 你已经把问题缩小到页面绑定、指令参数、设备连接中的某一类。
• 你不是通过盲目重建页面来解决问题。

快速恢复页面结构的可读性和可维护性。

1. 回到可视化编辑器，先看按钮名称是否和用途一致。
2. 检查动作类型是否是页面跳转、发送指令还是控制组。
3. 如果是跳转错误，直接核对目标页面 ID 或目标页面选择。
4. 如果是多个按钮名称相似，先统一重命名，再继续测试。
5. 修改后立即进入预览模式验证，不要一次改太多处。

• 页面和按钮只要命名清楚，80% 的误操作和误配置都能提前避免。
• 首页、菜单页、返回页的路径一定要固定，避免用户在现场迷路。

遇到系统级问题时，先找到正确入口。

1. 如果系统提示授权到期或功能不可用，先进入授权管理，不要先改项目页面。
2. 如果定时器没有执行，先看授权是否支持定时器，再看任务是否启用、是否有执行历史。
3. 如果换设备后配置不生效，先确认配置文件是否真的导入成功，再核对 IP、串口和授权是否匹配新设备。
4. 如果系统启动后配置像是回到默认状态，优先检查配置目录是否读对、备份是否覆盖错位置。

• 你知道授权问题去哪里看，定时器问题去哪里看，迁移问题去哪里看。
• 你不会把所有问题都归结为“软件不稳定”。