瑞丰彩・UV云打印・开放平台

---

## 目录

1. [什么是局域网接口？](#一什么是局域网接口)
2. [工作流程](#二工作流程)
3. [方案特点与限制](#三方案特点与限制)
4. [系统架构图](#四系统架构图)
5. [与互联网接口的区别](#五与互联网接口的区别)
6. [典型适用场景](#六典型适用场景)
7. [接口命令列表](#七接口命令列表)
8. [常见问题 FAQ](#八常见问题 faq)
9. [技术支持](#九技术支持)

---

## 一、什么是局域网接口？

### 官方定义

**局域网接口**是一种专为本地网络环境设计的高效、安全打印方案。

通过调用本地 API，将打印任务指令与图片数据直接发送至同一局域网内的指定打印机。

### 通俗解释

**简单说：局域网接口 = 本地直连打印**

就像在公司内部网络里，你的电脑直接"喊话"打印机，让它干活。不需要经过云端，数据不出内网。

### 核心特点

> 这是一套**局域网直连打印方案**，速度快、很安全，但功能比较基础，适合不联网、对速度有要求的封闭环境。

### 重要说明

⚠️ **普通局域网接口方案的限制：**
- 专注于普通任务打印场景
- 每一次打印都需要判断设备是否满足打印操作
- **不支持状态信息回调功能**

---
## 二、工作流程

局域网接口的工作流程分为 3 步：

### 1️⃣ 直连通信

你的业务软件在局域网内，直接"喊话"打印机软件，下达打印命令。

**通俗理解：** 就像在同一个房间里，你直接跟打印机说话，不用经过第三方转达。

### 2️⃣ 即时响应

打印机收到命令后，马上开始打印，几乎无等待。

**通俗理解：** 说完就干，不拖泥带水。

### 3️⃣ 简单反馈

接口只快速回复"命令收到成功与否"，然后流程结束。

**通俗理解：** 打印机回复一句"收到了"或"没收到"，没有后续的状态通知。

---

## 三、方案特点与限制

### ✅ 优点

| 特点 | 说明 | 通俗理解 |
|---|---|---|
| **高安全性** | 点对点直连，指令传输几乎无延迟 | 数据不经过外部，安全 |
| **高实时性** | 所有数据只在局域网内跑，不出内网，杜绝外泄风险 | 数据不出公司大门 |
| **高可靠性** | 不依赖互联网，不怕断网、网速慢 | 外网断了也不影响 |

### ⚠️ 限制

| 限制 | 说明 | 影响 |
|---|---|---|
| **不支持状态回调** | 打印完成后不会主动通知你 | 需要自己查询状态 |
| **每次打印需判断设备状态** | 每次打印前都要确认设备是否可用 | 需要额外调用查询接口 |
| **仅限局域网内使用** | 不能远程调用 | 离开公司/工厂就无法使用 |
| **功能较基础** | 没有云端调度、任务队列等高级功能 | 适合简单场景 |

---
## 四、系统架构图
![](https://rfccrm.oss-cn-shenzhen.aliyuncs.com/document/3d916868f567aab60d914e5d935d38de58d62cf1.png)

## 五、与互联网接口的区别

| 对比项 | 局域网接口 | 互联网接口 |
|---|---|---|
| **网络要求** | 同一局域网内 | 支持互联网远程调用 |
| **数据传输** | 数据不出内网 | 数据经过云端 |
| **状态回调** | ❌ 不支持 | ✅ 支持 |
| **离线能力** | 不适用（本身就是本地） | ✅ 支持（云端暂存任务） |
| **任务队列** | ❌ 不支持 | ✅ 支持 |
| **远程管理** | ❌ 不支持 | ✅ 支持 |
| **安全性** | ⭐⭐⭐⭐⭐ 最高 | ⭐⭐⭐⭐ 高 |
| **实时性** | ⭐⭐⭐⭐⭐ 最高 | ⭐⭐⭐⭐ 高 |
| **适用场景** | 本地封闭环境 | 远程管理、电商对接 |

### 怎么选？

```
追求极致安全 + 本地使用 + 不需要状态回调  →  局域网接口 ✅
需要远程管理 + 状态跟踪 + 电商对接        →  互联网接口 ✅
```

---

## 六、典型适用场景

### 网络受限或隔离的环境

**适用：** 涉密单位、生产线、仓库等不能或不便连接外网的地方。

**例子：**
- 政府涉密部门，数据不能出内网
- 工厂生产线，网络隔离
- 仓库内部，无外网连接

**优势：** 数据完全在内网流转，安全可控。

---

### 对打印实时性要求极高的环节

**适用：** 生产线上的实时标签打印、工单打印等。

**例子：**
- 产品流水线上，每个产品经过时立即打印标签
- 工单流转，实时打印生产指令
- 物流分拣，实时打印快递单

**优势：** 直连通信，几乎无延迟，满足实时性要求。

---

### 简单的本地/局域网单机应用

**适用：** 一台电脑管一两台打印机，不需要复杂的任务队列和状态监控，只求简单可靠。

**例子：**
- 小工作室，一台电脑控制一台打印机
- 办公室内部文件打印
- 门店内部标签打印

**优势：** 配置简单，使用方便，稳定可靠。

---

## 七、接口命令列表

局域网接口支持以下命令类型：

| 命令类型 | 用途 | 文档链接 |
|---|---|---|
| **对接指南** | 完整的对接步骤说明 | [查看](https://colorpark.cn/admin/guide/document?id=19) |
| **打印命令** | 发送打印任务 | [查看](https://colorpark.cn/admin/guide/document?id=13) |
| **查询命令** | 查询打印任务状态 | [查看](https://colorpark.cn/admin/guide/document?id=14) |
| **图片下载命令** | 上传图片到打印机 | [查看](https://colorpark.cn/admin/guide/document?id=15) |
| **设置白墨命令** | 配置白墨打印参数 | [查看](https://colorpark.cn/admin/guide/document?id=16) |
| **发送清洗** | 远程清洗喷头 | [查看](https://colorpark.cn/admin/guide/document?id=23) |
| **发送控制命令** | 发送设备控制指令 | [查看](https://colorpark.cn/admin/guide/document?id=25) |
| **设置专色** | 配置专色打印参数 | [查看](https://colorpark.cn/admin/guide/document?id=24) |

---

## 八、常见问题 FAQ

### Q1：局域网接口和互联网接口有什么区别？

**答：**

| 对比项 | 局域网接口 | 互联网接口 |
|---|---|---|
| 网络范围 | 同一局域网内 | 支持互联网远程 |
| 状态回调 | 不支持 | 支持 |
| 数据路径 | 直连，不出内网 | 经过云端 |
| 功能复杂度 | 基础 | 丰富 |

**简单说：** 局域网接口是本地直连，互联网接口是云端调度。

---

### Q2：局域网接口支持状态回调吗？

**答：** ❌ 不支持。

局域网接口只返回命令是否接收成功，不会在打印完成后主动通知你。如果需要知道打印状态，需要主动调用查询接口。

---

### Q3：什么情况下选择局域网接口？

**答：** 以下情况建议选择局域网接口：
- 数据不能出内网（涉密单位、工厂等）
- 不需要远程管理
- 对实时性要求极高
- 只需要基础打印功能
- 网络环境不稳定或无外网

---

### Q4：局域网接口可以在外网调用吗？

**答：** ❌ 不可以。

局域网接口要求调用方和打印机在**同一局域网内**。如果需要远程调用，请使用互联网接口。

---

### Q5：局域网接口的安全性如何？

**答：** ⭐⭐⭐⭐⭐ 安全性最高。

- 数据点对点直连，不经过第三方
- 所有数据只在局域网内传输，不出内网
- 杜绝数据外泄风险
- 不依赖互联网，不受外网攻击影响

---

### Q6：每次打印都需要判断设备状态吗？

**答：** ✅ 是的。

局域网接口方案中，每一次打印都需要判断设备是否满足打印操作。建议在调用打印命令前，先调用查询命令确认设备状态。

---

### Q7：局域网接口支持任务队列吗？

**答：** ❌ 不支持。

局域网接口是即时响应的，收到命令就执行，没有任务队列功能。如果需要任务排队、调度等功能，请使用互联网接口。

---

### Q8：如何查询打印任务状态？

**答：** 需要主动调用**查询命令**接口。

局域网接口不支持状态回调，所以需要你主动查询任务状态。具体接口参考"查询命令"文档。

---

### Q9：局域网接口支持哪些打印命令？

**答：** 支持以下命令：
- 打印命令
- 查询命令
- 图片下载命令
- 设置白墨命令
- 发送清洗命令
- 发送控制命令
- 设置专色命令

具体使用方法参考各命令的文档说明。

---

## 相关文档

以下文档与局域网接口相关，可能需要配合查看：

| 文档 | 用途 |
|---|---|
| 对接指南 | 完整的对接步骤说明 |
| 打印命令 | 发送打印任务的接口说明 |
| 查询命令 | 查询打印任务状态 |
| 图片下载命令 | 上传图片到打印机 |
| 设置白墨命令 | 配置白墨打印参数 |
| 发送清洗 | 远程清洗喷头 |
| 发送控制命令 | 发送设备控制指令 |
| 设置专色 | 配置专色打印参数 |
| 关于互联网接口 | 互联网接口详细说明（对比参考） |

---

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

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