瑞丰彩・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 格式，易于对接
> -  **订单打印** — 手动点击打印，图片转 TIF 格式传输

> **适用场景：** 单机环境、本地化部署、需要稳定通信的打印场景

![](https://rfccrm.oss-cn-shenzhen.aliyuncs.com/colorcloud/document/fee64bb705cc2b9d913065797e3aef558da97fd0.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. 双击打开 `WPFTcpCoinAiDesktop` 安装包
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:\WPFTcpCoinAiDesktop\
start WPFColorPark.exe
```

4. 保存关闭

---

## 首次使用

### 1. 启动软件

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

### 2. 进入首页

打开后进入软件主界面。

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

### 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. **完成打印位置测量** — 从打印机面对治具的视角：
   - 左上角为原点
   - 测量左边距（物品到左边的距离）
   - 测量上边距（物品到上边的距离）

---

## 日常打印操作

### 打印流程

```
建立连接 → 创建订单 → 选择订单 → 点击打印 → 图片转 TIF → 打印机输出
```

### 操作步骤

**1. 建立客户端连接**

启动软件后，确认三个状态灯均为绿色。

**2. 创建订单**

通过接口或手动方式创建打印订单。

**3. 选择订单**

在订单列表中选择要打印的订单。

**4. 点击打印**

点击 **打印** 按钮，图片将以 TIF 格式传输到打印机软件进行打印。

---

## 常用功能

### 1. 订单打印

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

**操作步骤：**

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

### 2. 设置旋转角度

**什么时候用？** 打印图案有倾斜，需要校正时

**操作步骤：**

1. 点击 **设置** → **系统设置**
2. 找到旋转角度设置
3. 根据情况填写角度值：

| 情况 | 角度值 | 说明 |
|------|--------|------|
| 逆时针旋转 | 负数 | 打印区域右侧向下倾斜，需要向上旋转 |
| 顺时针旋转 | 正数 | 打印区域右侧向上倾斜，需要向下旋转 |
| 默认 | 0 | 不旋转 |

> ???? **提示：** 默认角度为 0，若产品测试打印有倾斜再根据实际情况调整

### 3. 切换语言

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

**操作步骤：**

1. 点击右侧 **中文** 按钮
2. 在弹出的对话框中选择需要的语言
3. 点击 **确定** 保存配置

### 4. 查看版本信息

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

**操作步骤：**

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

### 5. 查看日志

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

**日志内容包括：**

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

**操作步骤：**

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

---

## 维护与保养

### 日常维护清单

| 频率 | 操作 |
|------|------|
| **每天** | 检查连接状态、查看订单状态 |
| **每周** | 清洗喷头 1 次、打印色块检测 |
| **每月** | 检查网络连接、查看日志 |

### 软件维护

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

### 连接状态检查

| 状态灯 | 正常 | 异常处理 |
|--------|------|----------|
| 服务器 | 绿色 | 检查 WiFi、ping 服务器 |
| 打印机 | 绿色 | 检查网线、PrintExp 是否开启 |
| 客户端 | 绿色 | 重启软件 |

---

## 常见问题 FAQ

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

**解决方法：**

1. 打开 **任务管理器**（Ctrl+Shift+Esc）
2. 切换到 **进程** 选项卡
3. 找到 `ColorMax`、`WPFColorPark`、`ColorPark` 等进程
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. 测试打印，根据效果微调

---

### Q10：订单卡住不打印怎么办？

**解决方法：**

1. 尝试重启软件
2. 检查连接状态是否正常
3. 取消订单后重新创建

---

### Q11：如何查看软件版本？

**操作步骤：**

1. 点击 **关于** 按钮
2. 查看当前版本号
3. 与服务商核对是否需要更新

---

### Q12：TCP 连接失败怎么办？

**排查步骤：**

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

---

### Q13：如何升级软件版本？

**操作步骤：**

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

---

### Q14：日志在哪里查看？

**操作步骤：**

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

---

## 获取帮助

### 官方文档

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

### 常见问题排查流程

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

---

## 附录

### 专业术语解释

| 术语 | 说明 |
|------|------|
| **打印机软件** | PrintExp 软件/汉森软件，控制打印机硬件 |
| **客户端软件** | 本软件（WPFTcpCoinAiDesktop），基于 TCP 协议的通信工具 |
| **TCP 长连接** | 保持持续连接的通信方式，数据实时传输 |
| **X / left** | 左边距，耗材与治具左边的距离 |
| **Y / top** | 上边距，耗材与治具上边的距离 |
| **JSON** | 数据交换格式，用于发送和接收数据 |
| **UTF8** | 字符编码格式，支持多语言 |

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

| 功能 | TCP 桌面版 | 互联网桌面版 |
|------|------------|--------------|
| **通信协议** | TCP 长连接 | HTTPS |
| **连接地址** | 127.0.0.1（本地） | 云端服务器 |
| **端口** | 63333（固定） | 443（HTTPS） |
| **使用场景** | 单机环境、本地部署 | 远程管理、云端对接 |
| **数据格式** | JSON | JSON |
| **安装包** | WPFTcpCoinAiDesktop.exe | WPFColorcloudCommon.exe |

### 软件界面速查

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

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

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

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

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