对接指南

一、文档说明

文档目的

本文档指导开发人员如何对接 TCP 协议，完成 TCP API 的调试与使用。

适用对象

开发人员
系统集成商
需要在局域网内对接 TCP 打印接口的技术人员

机器类型

| 类型 | 有无回调 | 是否支持货道 | 是否支持合并打印 | 适用商品类型 | 全/半自动 | 软件名 | 货道数 | 屏幕尺寸（英寸） | 屏幕方向 | 产品特性 | |---|---|---|---|---|---|---|---|---|---| | 桌面式 | 有回调 | 有货道 | 否 | （AI 式桌面机）吧唧、金币、冰箱贴、纪念币、亚克力板等 | 半自动 | AI 纪念币桌面版 | 二、三、四 | 7、10.1、15.6、24、27、32 | 竖屏、横屏 | 支持多款 AI 适应不同环境与人群、支持现场拍摄，需手动确认打印 | | 自助式 | 有回调 | 有货道 | 否 | （纪念币自助机）吧唧、金币、冰箱贴、纪念币、亚克力板等 | 全自动 | 纪念币打印终端常规式 | 二、三、四 | 7、10.1、15.6、24、27、32 | 竖屏、横屏 | 支持不同 DIY 风格纪念币，色彩鲜艳，支持自动打印 |

对接流程概览

1. 硬件准备 → 2. 软件安装 → 3. 测量物料 → 4. 接口调用 → 5. 完成对接

二、软件安装

1. 硬件准备

采购 UV 打印机硬件设备，同时确保设备能正常运行。

2. 软件获取

与技术支持人员获取最新的软件安装工具包，包括以下两个软件：

软件	作用
打印机软件（PrintExp）	使用网络数据传输连接到打印机，实现喷墨式打印
TCP 接口打印终端软件	接口调用后终端软件实时获得或从热文件夹里拉取图片转输给打印机软件

三、打印终端软件

安装步骤：

步骤	操作
1	双击 exe 安装包
2	点击"下一步"
3	点击"安装"
4	点击"完成"

四、软件安装流程

打印机软件（PrintExp）安装

安装步骤：

步骤	操作
1	双击 exe 安装包
2	点击"下一步"
3	点击"安装"
4	点击"完成"
5	弹出"微软常用运行库合集"弹框，点击"下一步" → "下一步" → "结束"

五、接口调用

调用前准备

参考文档，完成测量物料
然后按要求完成接口调用即可

接口列表

TCP 接口常用接口：

序号	接口名称	用途	文档链接
1	发送心跳包事件	保持连接活跃	查看
2	创建打印任务	发送打印任务	查看
3	取消打印任务	取消指定打印任务	查看
4	打印任务状态回调事件	接收打印任务状态通知	查看
5	打印机状态回调事件	接收打印机状态通知	查看
6	打印机缺墨回调事件	接收打印机缺墨通知	查看

调用流程

 1. 创建打印任务 → 2. 接收状态回调 → 3. 完成打印

六、常见问题 FAQ

Q1：对接前需要购买打印机吗？

答：是的。需要先采购 UV 打印机硬件设备，并确保设备能正常运行，然后才能进行软件安装和接口对接。

Q2：软件安装包从哪里获取？

答：与瑞丰彩技术支持人员获取最新的软件安装工具包。

Q3：桌面式和自助式有什么区别？

答：

对比项	桌面式	自助式
自动化程度	需要手动放料	全自动，支持自动打印
适用场景	AI 纪念币桌面机	纪念币自助机
产品特性	支持 AI 合成模板、现场拍摄	支持 DIY 风格、色彩鲜艳

Q4：PrintExp 和 TCP 终端软件都要安装吗？

答：是的，两个软件都需要安装：

PrintExp - 连接打印机，实现喷墨打印
TCP 终端软件 - 接收接口调用，转输图片给打印机软件

Q5：安装 PrintExp 时弹出的"微软常用运行库合集"是什么？

答：这是打印机软件运行所需的依赖库，按照安装向导提示完成安装即可（通常点击下一步直至结束）。

Q6：接口调用前需要做什么准备？

答：

完成物料测量（参考"测量物料"文档）
获取物料尺寸数据（width、height、left、top）
按要求完成接口调用

Q7：TCP 接口支持哪些回调事件？

答：支持以下 3 种回调事件：

打印任务状态回调
打印机状态回调
打印机缺墨回调

Q8：心跳包事件是什么？

答：心跳包用于保持 TCP 连接活跃，确保通信正常。需要定期发送心跳包到打印终端软件。

Q9：如何创建打印任务？

答：调用"创建打印任务"接口，传入物料尺寸参数和打印数据。具体参数参考接口文档。