云打印设备
云打印体验
行业案例
解决方案
OpenAPI
关于我们
开放平台
beta
中文
可以
简体中文
English
什么是云打印
云打印核心概念
客户端类型
如何测量物料
接口|互联网
接口|局域网
接口|TCP局域网
接口|AI生图
产品|AI拍照
产品|白皮书
产品|操作手册
-
分享
------------ ## 目录 1. [文档说明](#一文档说明) 2. [软件安装](#二软件安装) 3. [打印终端软件产品分类](#三打印终端软件产品分类) 4. [软件安装流程](#四软件安装流程) 5. [接口调用](#五接口调用) 6. [常见问题 FAQ](#六常见问题 faq) ------------ ## 一、文档说明 ### 文档目的 本文档指导开发人员如何对接 **TCP 局域网接口**，完成 TCP API 的调试与使用。 ### 适用对象 - 开发人员 - 系统集成商 - 需要在局域网内对接 TCP 打印接口的技术人员 ### 对接流程概览 ``` 1. 硬件准备 → 2. 软件安装 → 3. 测量物料 → 4. 接口调用 → 5. 完成对接 ``` --- ## 二、软件安装 ### 1. 硬件准备 采购 UV 打印机硬件设备，同时确保设备能正常运行。 ### 2. 软件获取 与技术支持人员获取最新的软件安装工具包，包括以下两个软件： | 软件 | 作用 | |---|---| | **打印机软件（PrintExp）** | 使用网络数据传输连接到打印机，实现喷墨式打印 | | **TCP 接口打印终端软件** | 接口调用后终端软件实时获得或从热文件夹里拉取图片转输给打印机软件 | --- ## 三、打印终端软件产品分类 TCP 打印终端软件分为两种类型： ### 产品分类总览 | 类型 | 有无回调 | 是否支持货道 | 适用商品类型 | 全/半自动 | 软件名 | 货道数 | 屏幕尺寸（英寸） | 屏幕方向 | 产品特性 | |---|---|---|---|---|---|---|---|---|---| | **桌面式** | 有回调 | 有货道 | （AI 式桌面机）吧唧、金币、冰箱贴、纪念币、亚克力板等 | 半自动 | AI 纪念币桌面版 | 二、三、四 | 7、10.1、15.6、24、27、32 | 竖屏、横屏 | 支持多款 AI 合成模板、适应不同环境与人群、支持现场拍摄，需手动确认打印 | | **自助式** | 有回调 | 有货道 | （纪念币自助机）吧唧、金币、冰箱贴、纪念币、亚克力板等 | 全自动 | 纪念币打印终端常规式 | 二、三、四 | 7、10.1、15.6、24、27、32 | 竖屏、横屏 | 支持不同 DIY 风格纪念币，色彩鲜艳，支持自动打印 | ### 桌面式（AI 纪念币桌面版）  | 项目 | 说明 | |---|---| | **类型** | 桌面式 | | **有无回调** | 有回调 | | **是否支持货道** | 无 | | **适用商品** | 吧唧、金币、冰箱贴、纪念币、亚克力板等 | | **全/半自动** | 半自动 | | **屏幕尺寸** | 7、10.1、15.6、24、27、32 英寸 | | **屏幕方向** | 竖屏、横屏 | | **产品特性** | 支持多款 AI 合成模板、适应不同环境与人群、支持现场拍摄，需手动确认打印 | ### 自助式（纪念币打印终端常规式）  | 项目 | 说明 | |---|---| | **类型** | 自助式 | | **有无回调** | 有回调 | | **是否支持货道** | 有货道 | | **适用商品** | 吧唧、金币、冰箱贴、纪念币、亚克力板等 | | **全/半自动** | 全自动 | | **屏幕尺寸** | 7、10.1、15.6、24、27、32 英寸 | | **屏幕方向** | 竖屏、横屏 | | **产品特性** | 支持不同 DIY 风格纪念币，色彩鲜艳，支持自动打印 | --- ## 四、软件安装流程 ### 打印机软件（PrintExp）安装 **安装步骤：** | 步骤 | 操作 | |---|---| | 1 | 双击 exe 安装包 | | 2 | 点击"下一步" | | 3 | 点击"安装" | | 4 | 点击"完成" | | 5 | 弹出"微软常用运行库合集"弹框，点击"下一步" → "下一步" → "结束" |  --- ### TCP 接口打印终端软件安装 **安装步骤：** | 步骤 | 操作 | |---|---| | 1 | 双击 exe 安装包 | | 2 | 点击"下一步" | | 3 | 点击"安装" | | 4 | 点击"完成" | --- ### 不同版本特色 | 版本 | 特色 | |---|---| | **桌面版** | 按钮/接口/自动 | | **自助机** | 各种横屏、竖屏/自助打印 | --- ## 五、接口调用 ### 调用前准备 1. 参考文档，完成 [测量物料](https://colorpark.cn/admin/guide/document?id=35) 2. 然后按要求完成接口调用即可 ### 接口列表 TCP 接口支持以下 6 个接口： | 序号 | 接口名称 | 用途 | 文档链接 | |---|---|---|---| | 1 | **发送心跳包事件** | 保持连接活跃 | [查看](https://colorpark.cn/admin/guide/document?id=26) | | 2 | **创建打印任务** | 发送打印任务 | [查看](https://colorpark.cn/admin/guide/document?id=27) | | 3 | **取消打印任务** | 取消指定打印任务 | [查看](https://colorpark.cn/admin/guide/document?id=28) | | 4 | **打印任务状态回调事件** | 接收打印任务状态通知 | [查看](https://colorpark.cn/admin/guide/document?id=29) | | 5 | **打印机状态回调事件** | 接收打印机状态通知 | [查看](https://colorpark.cn/admin/guide/document?id=30) | | 6 | **打印机缺墨回调事件** | 接收打印机缺墨通知 | [查看](https://colorpark.cn/admin/guide/document?id=31) | ### 调用流程 ``` 1. 发送心跳包 → 2. 创建打印任务 → 3. 接收状态回调 → 4. 完成打印 ``` --- ## 六、常见问题 FAQ ### Q1：对接前需要购买打印机吗？ **答：** 是的。需要先采购 UV 打印机硬件设备，并确保设备能正常运行，然后才能进行软件安装和接口对接。 --- ### Q2：软件安装包从哪里获取？ **答：** 与瑞丰彩技术支持人员获取最新的软件安装工具包。 --- ### Q3：桌面式和自助式有什么区别？ **答：** | 对比项 | 桌面式 | 自助式 | |---|---|---| | 自动化程度 | 半自动，需手动确认打印 | 全自动，支持自动打印 | | 适用场景 | AI 纪念币桌面机 | 纪念币自助机 | | 产品特性 | 支持 AI 合成模板、现场拍摄 | 支持 DIY 风格、色彩鲜艳 | --- ### Q4：PrintExp 和 TCP 终端软件都要安装吗？ **答：** 是的，两个软件都需要安装： - **PrintExp** - 连接打印机，实现喷墨打印 - **TCP 终端软件** - 接收接口调用，转输图片给打印机软件 --- ### Q5：安装 PrintExp 时弹出的"微软常用运行库合集"是什么？ **答：** 这是打印机软件运行所需的依赖库，按照安装向导提示完成安装即可（通常点击下一步直至结束）。 --- ### Q6：接口调用前需要做什么准备？ **答：** 1. 完成物料测量（参考"测量物料"文档） 2. 获取物料尺寸数据（width、height、left、top） 3. 按要求完成接口调用 --- ### Q7：TCP 接口支持哪些回调事件？ **答：** 支持以下 3 种回调事件： - 打印任务状态回调 - 打印机状态回调 - 打印机缺墨回调 --- ### Q8：心跳包事件是什么？ **答：** 心跳包用于保持 TCP 连接活跃，确保通信正常。需要定期发送心跳包到打印终端软件。 --- ### Q9：如何创建打印任务？ **答：** 调用"创建打印任务"接口，传入物料尺寸参数和打印数据。具体参数参考接口文档。 --- --- ## 相关文档 以下文档与 TCP 接口对接相关，可能需要配合查看： | 文档 | 用途 | |---|---| | 关于 TCP 接口 | TCP 接口详细说明 | | 如何测量物料 | 物料尺寸测量方法 | | 发送心跳包事件 | 保持连接活跃 | | 创建打印任务 | 发送打印任务 | | 取消打印任务 | 取消指定打印任务 | | 打印任务状态回调事件 | 接收打印任务状态通知 | | 打印机状态回调事件 | 接收打印机状态通知 | | 打印机缺墨回调事件 | 接收打印机缺墨通知 | --- 恭喜，你已经完成了 TCP 局域网接口的基本调用，可以在业务场景中正式使用了！ *若设备在调试过程中遇到不能解决问题，可以联系云打印负责人排除问题，找到解决的方法。联系方法如下： 电 话：137-5177-4454【微信同号】 邮 箱：info@ColorPark.cn* ##### *软硬件深度整合的UV云打印服务商 ® 瑞丰彩*
关于TCP接口
对接指南
发送心跳包事件
开始打印任务【仅支持自助机】
创建打印任务
待打印订单删除
取消打印任务
打印任务状态回调事件
打印机缺墨回调事件
打印机状态回调事件
