CMD 03 — 打印进度

最后更新:2026-09-22 15:58:34

读取打印进度用 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 }