客户端-互联网-操作手册

互联网桌面版客户端是运行在Windows电脑上的UV打印机控制软件，通过HTTPS连接远程服务器，实现订单接收、设备管理、打印控制、墨水监控、日志查看等功能，是控制打印机的“指挥中枢”

1. 软件简介

1.1 什么是互联网桌面版客户端？

瑞丰彩【互联网桌面版客户端软件】是一款运行在 Windows 电脑上的 UV 打印机控制软件。它通过 HTTPS 协议与远程服务器建立连接，实现订单接收、设备管理、打印控制、墨水监控、日志查看等核心功能。

简单来说：它是你控制打印机、接收打印订单、管理设备的"指挥中枢"。

1.2 核心功能一览

1.3 相关安装包说明

使用前需要准备以下安装包（联系售后获取）：

1.4 环境要求

在安装软件前，请确保你的电脑满足以下配置要求：

⚠️ 重要提示：本软件必须通过网线连接打印机，仅用 WiFi 无法与打印机建立通信。

2. 快速上手

2.1 首次启动与设备绑定

第一步：启动软件

• 双击桌面上的客户端图标，或
• 右键点击图标，选择 【打开】

首次启动时会弹出 【绑定设备】 弹框。

第二步：绑定设备

1. 找到打印机机身上的二维码
2. 扫描二维码，获取其中的数字编号（或直接在打印机背面查看编号）
3. 在绑定设备弹框中输入该数字编号
4. 点击 【确认】 按钮

绑定成功后，自动进入软件首页。

✅ 绑定成功标志：软件首页右上角的设备状态显示为绿色在线。

2.2 界面介绍

绑定设备后，你会看到软件的主界面。整个界面分为四大模块，通过顶部或左侧的标签切换：

各模块功能简介

2.3 下单方式说明

软件支持以下几种方式接收打印订单：

如何使用 AI 二维码下单？

1. 在软件首页，双击【设备编号】区域
2. 在弹出的菜单中选择：
   • AI-H5（AI酷玩风格）：适合趣味定制商品
   • AI-Pro（全能定制）：适合专业定制商品
3. 屏幕显示二维码后，让客户用手机微信或浏览器扫码
4. 客户在手机上上传图片、编辑内容、提交订单
5. 订单自动出现在软件的【打印】模块中

3. 功能详解

3.1 主页模块

主页是软件的核心操作面板，包含以下常用功能：

任务统计

实时显示当前设备的任务情况：

小技巧：点击数量数字，可以直接跳转到【打印】模块查看详情。

喷头检测

作用：快速判断打印头是否正常工作（所有喷嘴是否畅通、喷墨是否均匀）。

操作步骤：

1. 在首页点击 【喷头检测】
2. 打印机自动打印一张测试图
3. 观察测试图：
   • ✅ 正常：所有线条连续、无断线、无飞墨
   • ❌ 异常：缺失大于 10% 视为喷嘴堵塞，需要清洗喷头

清洗喷头

作用：当打印出现色差、线条断线或喷头堵塞时使用，恢复喷头的正常喷墨状态。

操作步骤：

1. 在首页点击 【清洗喷头】
2. 在弹出的确认框中点击 【确认】
3. 等待约 40 秒，清洗自动完成

⚠️ 注意事项：

• 清洗期间不要进行打印操作
• 软件每次启动后会自动清洗一次，无需手动操作
• 建议定期清洗，延长喷头使用寿命

墨水状态

在首页 【墨水状态】 区域，可以实时查看各色墨水的余量：

余量判断标准：

• 低于 30%：不足，请及时补充
• 高于 30%：充足

打印测试

作用：新机器首次使用或调整位置后，测试打印位置和效果是否正确。

操作步骤：

1. 在首页点击 【打印测试】
2. 打印机打印出一张测试二维码
3. 用手机微信或浏览器扫描该二维码
4. 在手机端上传图片、提交测试订单
5. 进入 【打印】 模块，选择测试订单点击 【打印】
6. 观察打印效果（位置是否准确、色彩是否正常）

打印模式切换

软件提供三种打印模式，适应不同的业务场景：

详见 第 5 章：打印模式说明

治具切换

治具是固定打印物品的托盘/模具，不同治具支持不同的打印方式：

⚠️ 重要：设备上安装的实体治具，必须与软件中选择的治具模板一一对应，否则无法正常使用合并打印功能。

3.2 打印模块

订单打印

操作步骤：

1. 点击顶部 【打印】 标签进入打印模块
2. 在订单列表中，勾选要打印的订单（支持单选和多选）
3. 点击 【打印】 按钮
4. 打印机开始执行打印任务

支持的文件格式：.jpg、.png、.tif、.pdf

取消订单

如果订单错误或有变动，可以取消：

1. 在打印模块中，找到要取消的订单
2. 点击该订单的 【取消】 按钮
3. 确认后，订单状态变为"已取消"

如何恢复已取消的订单？

• 进入 【设置】 → 【历史订单】
• 找到已取消的订单，点击 【恢复打印】
• 订单会重新出现在打印列表中

4.3 日志模块

日志模块记录软件运行期间的所有重要事件，用于排查问题。

日志类型：

4.4 设置模块

设置模块包含高级功能，建议在有经验后再使用。

维护校准类功能

关于"原点位置"的说明：

• 原点 = 打印机面对治具时，横轴与纵轴的右下角相交点
• 左边距（left）：耗材左侧与治具左边的距离
• 上边距（top）：耗材上侧与治具上边的距离

系统设置类功能

高级功能

4. 打印模式说明

4.1 单个订单打印

适用场景：每次只打印一个商品，治具模式为自由模式。

通过 AI 二维码下单并打印

客户扫码 → 上传图片 → 编辑内容 → 提交订单
          ↓
    软件接收订单 → 进入【打印】模块
          ↓
    勾选订单 → 点击【打印】→ 开始打印

通过开放平台 API 下单

如果你是通过自己的系统调用 API 自动下单，需要了解以下接口：

详细接口文档：请登录瑞丰彩开放平台查看 https://www.colorpark.cn/admin/guide/document?id=11

API 下单前的准备工作

1. 确认图片打印尺寸（宽度、高度）
2. 完成打印位置测量：
   • 从打印机面对治具的视角看
   • 左上角为原点，测量左边距和上边距
3. 在开放平台配置好相关参数

4.2 合并订单打印

适用场景：把多个订单的商品同时放入一块治具，一次打印完成，节省时间、提高效率。

使用前提

1. 设备已安装合并打印治具（实体）
2. 软件中已切换至对应的治具模板
3. 开放平台已配置好商品信息和治具绑定

通过开放平台 API 下单（合并打印）

步骤：

1. 确认每个商品的图片打印尺寸（宽度、高度）
2. 完成每个商品在治具上的打印位置测量（每个商品的 left/top 都不同）
3. 登录开放平台，新增商品信息（包含唯一标识、尺寸、图片等）
4. 在开放平台，选择设备并绑定治具及商品
5. 调用合并打印接口下单

合并打印接口说明：

详细操作指南：多治具与多任务打印操作指南 https://www.colorpark.cn/admin/guide/document?cate_id=88&&id=xxx

在客户端中执行合并打印

1. 在软件首页，将当前治具切换为已配置好的合并打印治具模板
2. 进入 【打印】 模块
3. 勾选多个订单（合并打印治具支持多选）
4. 点击 【打印】
5. 打印机同时打印多个订单

✅ 效率提升：合并打印可以让你在一次打印流程中完成多个订单，大幅节省时间和墨水。

5. 常见问题 FAQ

安装与启动问题

Q1：双击桌面图标无法打开软件，怎么办？

A：可能是软件进程卡住了。解决方法：

1. 按 Ctrl + Shift + Esc 打开任务管理器
2. 切换到 【进程】 选项卡
3. 找到 ColorMax、WPFColorMax、ColorMax、WPFColorMax 等进程
4. 右键选择 【结束任务】
5. 重新双击桌面图标启动软件

Q2：启动软件时提示"缺少 windowsdesktop-runtime-8.0.24-win-x64 框架"，怎么办？

A：没有安装运行环境框架。解决方法：

1. 找到 windowsdesktop-runtime-8.0.24-win-x64.exe 安装包
2. 双击运行，点击 【下一步】 直至完成
3. 重新启动客户端软件

连接问题

Q3：软件中"打印机"状态显示为红色（离线），怎么办？

A：请按顺序检查以下三项：

1. ✅ PrintExp 软件是否已打开？— 打开 PrintExp 并保持运行
2. ✅ 网线是否已连接？— 检查电脑与打印机之间的网线是否插好
3. ✅ 以太网是否已配置？— 按 2.2 环境配置 - 步骤四 检查 IP 配置是否正确

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

A：表示软件无法连接到远程服务器。解决方法：

1. 检查 WiFi 是否已连接，且网络可正常访问互联网
2. 测试服务器连接：
   • 按 Win + R，输入 cmd，回车
   • 输入 ping tprint.colorpark.cn，回车
   • 若显示"已发送 > 0，已接收 > 0"，表示连接正常
   • 若显示"请求超时"或"无法访问"，请检查网络连接

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

A：表示客户端与本地服务器（PrintExp）的连接异常。请确保 PrintExp 软件已打开且状态为在线，然后重启客户端软件。

打印问题

Q6：打印出来的图片位置偏移，怎么办？

A：需要调整打印位置参数：

1. 进入 【设置】 → 【角度坐标】
2. 如果图片整体偏移，调整 左边距（left） 和 上边距（top）
3. 如果图片有旋转偏移，调整旋转角度（正数 = 顺时针，负数 = 逆时针）
4. 保存后重新打印测试

提示：角度坐标 应用于单个订单模式；夹具角度 应用于合并打印模式。

Q7：打印出现色差、断线或飞墨，怎么办？

A：这是喷头堵塞的表现，需要清洗喷头：

1. 进入 【设置】 → 【清洗喷头】
2. 等待约 40 秒清洗完成
3. 打印喷头测试图，检查喷嘴状态
4. 如果问题依旧，可重复清洗 2-3 次

Q8：无法播放视频，怎么办？

A：请检查视频文件是否存在：

1. 打开软件安装目录（默认 C:\WPFColorcloudCommon\）
2. 进入 data\media\ 文件夹
3. 确认 video.mp4 文件是否存在
4. 如果不存在，请联系售后获取视频文件并放入该目录

其他问题

Q9：软件卡顿或无响应，怎么办？

A：尝试重启软件：

1. 进入 【设置】 → 点击 【程序重启】
2. 软件会自动关闭并重新打开，订单数据会初始化刷新

Q10：如何备份和恢复我的配置？

A：

• 备份：右键桌面图标 → 打开文件所在位置 → 复制 data 文件夹到安全位置
• 恢复：将备份的 data 文件夹复制到软件安装目录下，选择替换即可

6. 附录

6.1 专业术语解释

6.2 联系方式与支持渠道