CMD 04 — 墨水状态

最后更新：2026-09-22 15:58:37

查询各颜色墨盒余量百分比，数据来源于板卡 GetInkDisPlay。

项目	内容
接口名称	墨水状态
命令标识	`CMD_ID` = `04`
请求方式	POST
URL	`http://{设备IP}:8555/api/app_print`
内容类型	application/json

请求参数

名称	类型	必填	说明
CMD_ID	string	是	固定 `"04"`

请求示例

{ "CMD_ID": "04" }

响应参数

名称	类型	说明
CMD_ID	string	`"04"`
code	int	`0` 表示成功
data	array	墨水通道列表，见下表

data[] 元素

名称	类型	说明
name	string	通道名：C / Y / K / M / W 等
percent	int	余量百分比 0~100；未知为 `-1`

响应示例

{
  "CMD_ID": "04",
  "code": 0,
  "data": [
    { "name": "C", "percent": 80 },
    { "name": "Y", "percent": 65 },
    { "name": "K", "percent": 12 },
    { "name": "M", "percent": 90 },
    { "name": "W", "percent": 40 }
  ]
}

说明：设备未联机或 SDK 接口不可用时，data 可能为空数组 []，仍返回 code: 0。