读取打印进度用 CMD 03 跟踪打印过程。
开始前需要准备什么?
先确认内机型号、固件和设备 IP;当前通信说明使用本地 HTTP 地址与 CMD_ID 命令。
分类名称含 TCP,但实际请求方式以“通信约定与通用规范”为准。这里的调用示例只适用于嵌入式协议。
接下来:对照代码示例 →
查询板卡打印进度。
| 项目 |
内容 |
| 接口名称 |
打印进度 |
| 命令标识 |
CMD_ID = 03 |
| 请求方式 |
POST |
| URL |
http://{设备IP}:8555/api/app_print |
| 内容类型 |
application/json |
请求参数
| 名称 |
类型 |
必填 |
说明 |
| CMD_ID |
string |
是 |
固定 "03" |
请求示例
{ "CMD_ID": "03" }
响应参数
| 名称 |
类型 |
说明 |
| CMD_ID |
string |
"03" |
| code |
int |
0 表示成功 |
| progress |
int |
打印进度 0~100;无打印任务或任务已结束时为 0 |
进度变化规则
- CMD 01 受理后、RIP 完成前:
progress 恒为 0
- StartPrint 下发后:progress 随板卡回调递增
- 打印完成或会话结束后:progress 重置为 0
响应示例
打印中
{ "CMD_ID": "03", "code": 0, "progress": 35 }
无任务 / 已完成
{ "CMD_ID": "03", "code": 0, "progress": 0 }