瑞丰彩・UV云打印・开放平台

> 基于 TCP 协议 · 本地通信 · 无人值守 · 自动打印

---

## 目录

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

---

## 软件是什么

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

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

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

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

![](https://rfccrm.oss-cn-shenzhen.aliyuncs.com/colorcloud/document/1ebaf0a5074dd38340c62dbaf9171f5a93e2ef0f.png)

---

## 开始前准备

### 电脑要求

| 项目 | 最低配置 | 推荐配置 |
|------|----------|----------|
| **操作系统** | Windows 10 (64 位) | Windows 11 (64 位) |
| **处理器** | Intel i3 或同级 | Intel i5 或更高 |
| **内存** | 8GB | 8GB 及以上 |
| **硬盘空间** | 至少 10GB 可用 | 20GB 及以上（建议固态硬盘 256G） |
| **网络** | WiFi4 及以上 | WiFi5 及以上，稳定网络环境 |

### 需要准备的物品

- ✅ 瑞丰彩 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. 填写以下信息：

| 项目 | 填写内容 |
|------|----------|
| IP 地址 | 192.168.127.11 |
| 子网掩码 | 255.255.255.0 |
| 默认网关 | 192.168.127.1 |
| 首选 DNS | 8.8.8.8 |

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. 检查连接状态

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

| 状态 | 绿色 ✅ | 红色 ❌ |
|------|---------|---------|
| **服务器** | 已连接云端 | 未联网，检查 WiFi |
| **打印机** | 已连接打印机 | 未连接，检查网线 |
| **客户端** | 软件运行正常 | 异常，重启软件 |

---

## 连接与通信

### TCP 连接配置

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

| 参数 | 值 | 说明 |
|------|-----|------|
| **IP 地址** | 127.0.0.1 | 本地回环地址（局域网内使用对应 IP） |
| **端口** | 63333 | 固定端口 |
| **连接方式** | TCP | TCP 长连接 |
| **编码格式** | UTF8 | 收发数据全部采用 UTF8 编码 |
| **数据格式** | JSON | 数据发送与接收都采用 JSON 格式 |

### 核心接口

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 | 否 | 某货道库存不足会预警，货道间不切换 |

**操作步骤：**

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

### 3. 恢复出厂设置

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

**出厂默认值：**

| 货道 | X 坐标 | Y 坐标 |
|------|--------|--------|
| 一货道 | 12 | 12 |
| 二货道 | 92 | 12 |
| 三货道 | 172 | 12 |

**操作步骤：**

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

### 4. 订单打印

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

**操作步骤：**

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

### 5. 清洗喷头

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

**操作步骤：**

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

> ⚠️ **注意：** 
> - 软件启动后会自动清洗一次
> - 清洗期间建议不做打印操作

### 6. 查看墨量

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

**操作步骤：**

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

| 余量 | 状态 |
|------|------|
| < 30% | 不足，需要加墨 |
| > 30% | 充足 |

### 7. 切换维护状态

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

**操作步骤：**

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

### 8. 切换语言

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

**操作步骤：**

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

### 9. 最小化窗体

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

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

### 10. 程序重启

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

**操作步骤：**

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

### 11. 查看版本信息

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

**操作步骤：**

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

### 12. 查看系统日志

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

**日志内容包括：**

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

**操作步骤：**

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

---

## 日常维护

### 每日巡检清单

| 检查项 | 操作 | 正常状态 |
|--------|------|----------|
| **服务器状态** | 查看状态灯 | 绿色 ✅ |
| **打印机状态** | 查看状态灯 | 绿色 ✅ |
| **墨量检查** | 墨水容量查询 | > 30% |
| **货道状态** | 检查库存是否充足 | 正常 |
| **连接状态** | 检查 TCP 连接 | 正常 |

### 每周维护

| 项目 | 操作 |
|------|------|
| **清洗喷头** | 清洗喷头 1 次 |
| **打印测试** | 打印色块检测质量 |
| **货道检查** | 检查货道商品库存 |
| **日志清理** | 查看并上传日志后清理 |

### 每月维护

| 项目 | 操作 |
|------|------|
| **软件版本** | 检查并升级到最新版本 |
| **深度清洁** | 清洁机器表面和内部灰尘 |
| **网络优化** | 检查 WiFi 信号强度，必要时调整 |
| **备份配置** | 备份 data 文件夹 |

### 喷头保养

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

### 软件维护

- ✅ 定期检查版本更新
- ✅ 遇到问题先重启软件
- ✅ 定期清理日志文件
- ✅ 卸载前备份 `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

### 常见问题排查流程

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

---

## 附录

### 专业术语解释

| 术语 | 说明 |
|------|------|
| **打印机软件** | PrintExp 软件/汉森软件，控制打印机硬件 |
| **客户端软件** | 本软件（WPFTcpCoinNormal），基于 TCP 协议的自助打印工具 |
| **TCP 长连接** | 保持持续连接的通信方式，数据实时传输 |
| **X / left** | 左边距，耗材与治具左边的距离 |
| **Y / top** | 上边距，耗材与治具上边的距离 |
| **JSON** | 数据交换格式，用于发送和接收数据 |
| **UTF8** | 字符编码格式，支持多语言 |
| **货道** | 自助机存放耗材的通道，可配置多个 |
| **维护状态** | 设备暂停接单，用于补货或维修 |

### TCP 自助版 vs TCP 桌面版 区别

| 功能 | TCP 自助版 | TCP 桌面版 |
|------|------------|------------|
| **使用场景** | 无人值守、自助打印 | 有人操作、本地部署 |
| **打印模式** | 进料/即时/等待指令三种 | 手动打印 |
| **货道管理** | 支持多货道配置 | 不支持 |
| **维护状态** | 支持切换 | 不支持 |
| **安装包** | WPFTcpCoinNormal.exe | WPFTcpCoinAiDesktop.exe |

### TCP 版 vs 互联网版 区别

| 功能 | TCP 版 | 互联网版 |
|------|--------|----------|
| **通信协议** | TCP 长连接 | HTTPS |
| **连接地址** | 127.0.0.1（本地） | 云端服务器 |
| **端口** | 63333（固定） | 443（HTTPS） |
| **使用场景** | 单机环境、本地部署 | 远程管理、云端对接 |

### 软件界面速查

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

| 区域 | 功能 |
|------|------|
| ① 服务器状态 | 云端连接状态（绿=正常） |
| ② 打印机状态 | 设备连接状态（绿=正常） |
| ③ 客户端状态 | 本地连接状态（绿=正常） |
| ④ 订单列表 | 待打印的订单 |
| ⑤ 打印按钮 | 选中订单后点击开始打印 |
| ⑥ 设置按钮 | 进入系统设置 |
| ⑦ 关于按钮 | 查看版本信息 |
| ⑧ 语言切换 | 中/英/繁体切换 |
| ⑨ 系统日志 | 操作记录和故障信息 |
| ⑩ 切换维护 | 暂停/继续打印 |

------------

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

##### *软硬件深度整合的UV云打印服务商  &reg; 瑞丰彩*