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

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

1. 软件简介

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

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

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

1.2 核心功能一览

1.3 相关安装包说明

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

1.4 环境要求

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

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

2. 快速上手

2.1 首次启动与设备绑定

第一步：启动软件

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

首次启动时会弹出 【绑定机器码】 弹框；弹框左上角可切换语言（简体中文 / 繁体中文 / 英文 / 日文），底部显示当前软件版本号（如 V3.5.2）。

第二步：绑定机器码

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

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

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

2.2 界面介绍

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

各模块功能简介

???? 界面布局说明：软件顶部显示当前设备编号、打印机/服务器连接状态；左侧为四大模块导航；右侧主区域展示对应模块内容；底部状态栏显示当前打印模式、治具信息及最新操作提示。

2.3 下单方式说明

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

如何使用 AI 二维码下单？

1. 在软件首页，单击【设备编号】区域
2. 在弹出的菜单中选择：
   • AI-H5（AI酷玩风格）：适合趣味定制商品
   • AI-Pro（全能定制）：适合专业定制商品
3. 屏幕显示二维码后，让客户用手机微信或浏览器扫码

二维码弹窗底部会提示“当前设备关联的二维码，扫码后可完成下单”，可通过左右箭头在两种风格之间切换：

1/2 · AI-Pro（全能定制）：适合专业定制商品。

2/2 · AI-H5（AI 酷玩风格）：适合趣味定制商品。

1. 客户在手机上上传图片、编辑内容、提交订单
2. 订单自动出现在软件的【打印】模块中

3. 功能详解

3.1 主页模块

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

任务统计

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

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

喷头检测

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

操作步骤：

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

清洗喷头

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

操作步骤：

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

⚠️ 注意事项：

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

墨水状态

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

余量判断标准：

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

???? 墨水状态以柱状图形式展示，并在柱底显示“不足/充足/未满”等文字提示，方便快速判断。

下图红框处即为首页的【墨水状态】区域，柱底文字会直接提示“不足 / 充足 / 未满”：

打印测试

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

操作步骤：

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

打印模式切换

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

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

治具切换

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

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

首页底部状态栏右侧会显示当前治具（如“当前治具:自由模式”），点击该区域即可进入治具切换流程：

第一步，在弹出的窗口中确认当前治具示意图，点击左下角的 【更换治具】 按钮：

第二步，在【夹具选择】中选择与实际安装一致的商品模板（如 GOLF），必要时点击 【刷新】 重新读取设备治具，确认后点击 【确定】 完成模板切换：

⚠️ 注意：请先手动更换好设备上的实体治具，再在软件中切换对应模板；治具必须与下单的商品一致，否则无法完成下单操作。

3.2 打印模块

订单打印

操作步骤：

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

列表字段说明：

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

删除订单

如果订单错误或有变动，可以删除：

1. 在打印模块中，勾选要删除的订单
2. 点击底部 【删除当前】 或 【删除所有】 按钮
3. 确认后，订单从当前列表移除

如何恢复已删除的订单？

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

???? 右侧预览区：选中订单后，右侧会显示该订单的打印预览图及商品信息（如“纪念币*1 彩色”）。未选择订单时，提示“请勾选任务选择框”。

3.3 日志模块

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

日志类型：

界面说明：

• 顶部可按日志类型筛选（如 All），点击 【确定】 应用筛选
• 表格列包括：日志时间、类型（Info/Warn/Error）、实时日志（详细内容）
• 底部状态栏同步显示最新操作提示

???? 遇到问题时，可点击右上角 【上传日志】 将日志提交给开发商，帮助快速定位和解决问题。

3.4 设置模块

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

常用功能

功能	说明	图片
喷头检测	同主页功能，检测喷嘴状态
清洗喷头	同主页功能，清洗喷头
打印色块	打印色块测试图，检查色彩是否准确
打印线框	打印定位线框，用于测量打印起始点（原点）位置

维护校准

功能	说明	图片
系统装墨	装墨并排气，确保墨水供给正常
角度坐标	调整图片旋转角度，修正打印偏移
雕刻设置	配置雕刻相关参数
切换维护	将设备切换为维护状态
网络连接	配置网络连接参数
平台移动	控制装载模具的平台调整移动
远程服务	开启远程服务支持

系统设置

功能	说明	图片
更换治具	更换实体治具后，在软件中切换对应模板
语言切换	切换软件显示语言
播放视频	设置需要播放的视频并在设备上播放宣传视频
上传日志	将日志文件上传给开发商，用于排查问题
网络检测	检测当前网络连接速度
更新软件	检查并安装最新版本软件
打印模式	同主页功能，切换手动/接口/循环打印模式
历史订单	查看近 50 条已完成或已取消的订单，支持恢复打印
自动清图	设置自动清理本地缓存图片的时间间隔
平台伸缩	配置打印平台伸缩参数
打印版本	查看或切换汉森打印软件的版本
功能显示	配置界面功能显示选项

关键操作

功能	说明	图片
程序重启	软件卡顿时，重启软件初始化数据，直接点击重启
退出程序	安全退出客户端软件
软件解绑	解绑当前设备，绑定到其他电脑时使用
调整参数	进入高级参数调整界面

关于“原点位置”的说明：

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

打印位置测量示意图

下图展示了耗材在治具上的摆放方式以及左边距（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 等进程
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. ✅ 以太网是否已配置？— 检查 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 联系方式与支持渠道

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

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