客户端-局域网|TCP|自助机-操作手册

基于TCP长连接的无人值守自助打印管理工具，使用本地回环地址（127.0.0.1）通信，无需外网，支持进料/即时/等待指令三种打印模式、多货道配置与缺货自动切换，适用于单机自助、本地化部署、无人值守场景。

目录

1. 软件是什么
2. 开始前准备
3. 安装与设置
4. 首次使用
5. 连接与通信
6. 顾客使用流程
7. 运维管理功能
8. 日常维护
9. [常见问题 FAQ](#常见问题 FAQ)
10. 获取帮助

软件是什么

瑞丰彩 TCP 自助版客户端软件，是一个基于 TCP 协议的无人值守打印管理工具。

简单说：这是一款让自助打印机在本地网络内自动工作的软件。它使用 TCP 长连接，数据传输稳定可靠，适合单机环境下的自助打印服务。

核心特点：

• TCP 长连接 — 稳定可靠，实时通信
• 本地通信 — IP 指向本机（127.0.0.1），无需外网
• 自动打印 — 支持进料打印、即时打印、等待指令三种模式
• JSON 数据 — 收发数据采用 JSON 格式，易于对接
• 货道管理 — 支持多货道配置和缺货自动切换

适用场景： 单机自助环境、本地化部署、无人值守打印场景

开始前准备

电脑要求

需要准备的物品

• ✅ 瑞丰彩 UV 打印机（已通电）
• ✅ Windows 电脑（台式机或笔记本，建议触控屏）
• ✅ 网线（连接电脑和打印机）
• ✅ 软件安装包（联系售后获取）

安装与设置

第一步：关闭防火墙和杀毒软件

为什么要关闭？ 防火墙和杀毒软件可能会阻止 TCP 通信。

操作步骤：

1. 打开 控制面板 → 系统和安全 → Windows Defender 防火墙
2. 点击 启用或关闭 Windows Defender 防火墙
3. 在"专用网络"和"公用网络"下都选择 关闭
4. 点击 确定 保存

卸载杀毒软件（如 360、瑞星等）：

1. 右键 开始菜单 → 设置 → 应用
2. 找到杀毒软件，点击 卸载
3. 勾选 删除用户配置文件，完成卸载

第二步：安装打印机软件 PrintExp

1. 双击打开 PrintExp 安装包
2. 点击 下一步 → 安装 → 完成
3. 弹出"微软常用运行库合集"窗口，点击 下一步 → 结束

第三步：配置打印机网络

1. 点击电脑右下角 网络图标 → 更改适配器选项
2. 找到 以太网/以太网 4，右键 → 属性
3. 双击 Internet 协议版本 4 (TCP/IPv4)
4. 填写以下信息：

5. 点击 确定 保存

第四步：安装客户端软件

1. 双击打开 WPFTcpCoinNormal 安装包
2. 勾选 创建桌面快捷方式
3. 选择安装路径（默认 C 盘）
4. 点击 下一步 或 安装，等待完成

第五步：设置开机自启动（必做）

自助版机器必须设置开机自启动，确保断电重启后自动运行。

方式 1：简单启动

1. 按 Win + R 键，输入 shell:startup，回车
2. 打开启动文件夹
3. 将客户端软件的快捷方式复制到此文件夹

方式 2：延迟启动（推荐）

1. 按 Win + R 键，输入 shell:startup，回车
2. 在打开的文件夹中创建 start.bat 文件
3. 用记事本打开，输入以下内容：

Timeout 10
C:
cd C:\WPFTcpCoinNormal\
start WPFColorPark.exe

4. 保存关闭

首次使用

1. 启动软件

双击桌面上的客户端软件图标，打开软件。

2. 进入首页

打开后进入软件主界面。

3. 检查连接状态

在软件界面上方，检查三个状态指示灯：

连接与通信

TCP 连接配置

TCP 自助版使用本地回环地址进行通信，配置如下：

核心接口

TCP 自助版支持以下核心接口调用：

???? 提示： 详细接口文档请参考 TCP 接口说明：https://www.colorpark.cn/admin/guide/document?id=32

调用前提

在调用接口前，需要完成以下准备：

1. 确认图片打印尺寸 — 测量宽度和高度
2. 完成打印位置测量 — 从打印机面对治具的视角：
   • 左上角为原点
   • 测量左边距（物品到左边的距离）
   • 测量上边距（物品到上边的距离）

顾客使用流程

自助打印完整流程

顾客扫码 → 选择图案 → 下单支付 → 自动排队 → 打印完成 → 取货

步骤说明

1. 扫码下单

顾客使用微信扫描机器上的二维码，进入小程序/H5 页面。

2. 选择图案

在小程序中选择或上传要打印的图案。

3. 下单支付

确认订单信息并完成支付。

4. 自动排队

下单成功后，客户端自动进入排队打印页面，显示进度条。

5. 打印完成

进度条加载完成，打印完成。

6. 顾客取货

机器自动推出打印好的商品，顾客取货离开。

运维管理功能

1. 选择打印模式

什么时候用？ 根据不同自助场景选择合适的打印模式

三种模式：

操作步骤：

1. 点击 设置 → 系统设置
2. 选择 打印模式
3. 根据场景选择合适的模式

2. 货道参数配置

什么时候用？ 配置货道商品种类和缺货切换策略

三种场景：

操作步骤：

1. 点击 设置 → 系统设置
2. 选择 货道参数
3. 配置货道商品种类和自动跳转设置

3. 恢复出厂设置

什么时候用？ 货道打印位置需要重置时

出厂默认值：

操作步骤：

1. 点击 设置 → 系统设置
2. 选择 恢复出厂
3. 确认恢复

4. 订单打印

什么时候用？ 有订单需要打印时

操作步骤：

1. 建立客户端连接
2. 创建订单后，订单出现在列表
3. 手动点击 打印 按钮
4. 图片以 TIF 格式传输到打印机软件进行打印

5. 清洗喷头

什么时候用？ 打印出现色差或阻塞时

操作步骤：

1. 点击 设置 → 系统设置
2. 选择 清洗喷头 → 清洗喷头
3. 等待约 40 秒完成

⚠️ 注意：

• 软件启动后会自动清洗一次
• 清洗期间建议不做打印操作

6. 查看墨量

什么时候用？ 定期检查墨水余量，及时补充

操作步骤：

1. 点击 设置 → 系统设置
2. 选择 墨水容量
3. 查看 CMYK 四色墨水和废墨余量

7. 切换维护状态

什么时候用？ 补货或暂停订单打印时

操作步骤：

1. 点击 切换维护 按钮
2. 设备进入维护状态，暂停打印
3. 补货完成后，双击"当前设备正在维护中"按钮
4. 订单继续打印

8. 切换语言

支持语言： English、简体中文、繁體中文

操作步骤：

1. 点击 语言切换
2. 在弹出的对话框中选择需要的语言
3. 点击 确定 保存配置

9. 最小化窗体

什么时候用？ 需要切换到其它功能操作时

操作步骤： 点击 最小化 按钮，缩小客户端软件

10. 程序重启

什么时候用？ 软件或订单卡顿时

操作步骤：

1. 点击 设置 → 系统设置
2. 选择 程序重启
3. 软件自动关闭并重新打开

11. 查看版本信息

什么时候用？ 核对软件版本、确认是否需要更新时

操作步骤：

1. 点击 关于 按钮
2. 查看当前软件版本号
3. 与服务商核对功能及版本

12. 查看系统日志

什么时候用？ 排查问题、查看操作记录时

日志内容包括：

• 本次启动后所有操作日志
• 服务器连接状态
• 打印机连接状态
• 故障信息

操作步骤：

1. 点击 设置 → 系统设置
2. 选择 系统日志 查看

日常维护

每日巡检清单

每周维护

每月维护

喷头保养

• ✅ 打印出现色差时及时清洗
• ✅ 长时间不用时，每周至少清洗一次
• ⚠️ 清洗期间暂停打印操作

软件维护

• ✅ 定期检查版本更新
• ✅ 遇到问题先重启软件
• ✅ 定期清理日志文件
• ✅ 卸载前备份 data 文件夹（保存配置）

常见问题 FAQ

Q1：双击软件图标没反应，打不开怎么办？

解决方法：

1. 打开 任务管理器（Ctrl+Shift+Esc）
2. 切换到 进程 选项卡
3. 找到 ColorMax、WPFColorMax、ColorPark、WPFColorPark 等进程
4. 右键 → 结束任务
5. 重新双击图标启动

Q2：软件启动失败，提示缺少.NET Framework 4.8.1？

解决方法：

1. 下载 .NET Framework 4.8.1 安装包
   • 官网：https://dotnet.microsoft.com/zh-cn/download/dotnet-framework/net481
   • 或联系售后获取
2. 双击安装包，按提示完成安装
3. 重启软件

Q3：软件显示"打印机状态红色"怎么办？

可能原因：

• 打印机软件 PrintExp 未打开
• 网线未连接或松动
• 网络配置不正确

解决方法：

1. 打开 PrintExp 软件并保持在线
2. 检查网线是否连接好
3. 检查以太网配置是否正确（见安装步骤）

Q4：软件显示"服务器状态红色"怎么办？

可能原因：

• WiFi 未连接
• 网络不稳定
• 服务器连接异常

解决方法：

1. 检查 WiFi 是否已连接
2. 打开命令提示符（Win+R → 输入 cmd → 回车）
3. 输入 ping tprint.colorpark.cn 回车
4. 如果显示"已发送>0，已接收>0"，说明网络正常
5. 否则切换更稳定的网络

Q5：软件显示"客户端状态红色"怎么办？

可能原因： 客户端与服务器本地连接未建立

解决方法：

1. 检查 TCP 连接配置是否正确（IP: 127.0.0.1, 端口：63333）
2. 重启软件
3. 如仍无法解决，联系技术支持

Q6：视频无法播放怎么办？

解决方法：

1. 检查视频文件是否存在
2. 路径：安装路径\data\media\video.mp4
3. 如文件不存在，复制或重新放置视频文件

Q7：如何备份软件配置？

操作步骤：

1. 右键桌面软件图标 → 打开文件所在的位置
2. 找到 data 文件夹
3. 复制 data 文件夹到安全位置（如桌面）
4. 重装或升级后，将备份的 data 文件夹复制回安装路径

Q8：如何完全卸载软件？

操作步骤：

1. 打开软件，点击右上角 退出
2. 右键桌面图标 → 打开文件所在的位置
3. 复制 data 文件夹到桌面备份
4. 双击 unins000.exe
5. 确认卸载，选择 是

Q9：打印质量变差怎么办？

可能原因： 喷头堵塞或墨量不足

解决方法：

1. 打印色块检测质量
2. 如色块有问题，清洗喷头
3. 检查墨量，不足时及时加墨
4. 如仍无法解决，联系技术支持

Q10：货道缺货怎么办？

解决方法：

1. 检查货道参数配置
2. 如设置为"自动跳转：是"，会自动切换到货道
3. 如设置为"自动跳转：否"，会预警提示
4. 及时补充货道商品

Q11：顾客下单后不打印怎么办？

排查步骤：

1. 检查订单是否在排队列表中
2. 检查是否处于"维护中"状态
3. 检查墨量是否充足
4. 检查货道是否有货
5. 尝试重启软件

Q12：如何升级软件版本？

操作步骤：

1. 卸载旧版本（先备份 data 文件夹）
2. 安装新版本
3. 将备份的 data 文件夹复制回安装路径

Q13：日志在哪里查看？

操作步骤：

1. 点击 设置 → 系统设置
2. 选择 系统日志
3. 查看操作记录、连接状态、故障信息

Q14：TCP 连接失败怎么办？

排查步骤：

1. 检查 IP 是否为 127.0.0.1
2. 检查端口是否为 63333
3. 检查防火墙是否已关闭
4. 检查 PrintExp 是否运行
5. 重启软件重试

获取帮助

官方文档

• 开放平台：https://www.colorpark.cn/admin/login/login
• TCP 接口文档：https://www.colorpark.cn/admin/guide/document?id=32

常见问题排查流程

问题发生
    ↓
查看状态指示灯
    ↓
检查系统日志（设置 → 系统设置 → 系统日志）
    ↓
根据错误信息搜索解决方案
    ↓
尝试重启软件
    ↓
联系技术支持

附录

专业术语解释

TCP 自助版 vs TCP 桌面版 区别

TCP 版 vs 互联网版 区别

软件界面速查

![界面标注] (此处放置完整界面标注图，标注各区域功能)

若设备在调试过程中遇到不能解决问题，可以联系云打印负责人排除问题，找到解决的方法。联系方法如下： 电 话：137-5177-4454【微信同号】 邮 箱：info@ColorPark.cn

软硬件深度整合的UV云打印服务商 ® 瑞丰彩