启枢科技文档

启枢档案馆

这里是后续撰写产品文档的入口页。左侧负责文档分类与章节层级，右侧保留正式文档正文、提示块、代码、表格与上一页 / 下一页的位置。

commands / cpcl/boxliy

CPCL Boxliy

CpclBoxliy 支持的 CPCL 指令清单。

CpclBoxliy 是 NIB CPCL 指令的基础 Family，适合页式标签打印和移动标签机。

Boxliy 命令清单

具体机器支持哪些协议、Family 和参数值，需要以目标机器固件为准；机器支持列表请联系开发人员或客服确认。

SDK 方法	实际指令	参数	作用	返回 / 备注
`begin(height, copies) / page(...)` 打印与版面	`! 0 200 200 {height} {copies}`	height: 页面高度；copies: 份数。	开始 CPCL 页面。	-
`pageWidth(width)` 打印与版面	`PAGE-WIDTH {width}`	width: 页面宽度。	设置页面宽度。	-
`gapSense()` 纸张 / 介质	`GAP-SENSE`	-	启用间隙纸检测。	-
`barSense()` 纸张 / 介质	`BAR-SENSE`	-	启用黑标检测。	Java SDK 暴露。
`paperType(type)` 纸张 / 介质	`GAP-SENSE / BAR-SENSE / no-op`	type: GAP、BLACK_MARK、CONTINUOUS。	按纸张类型选择检测方式。	-
`text(...)` 打印与版面	`T{rotation} {fontFamily} {fontSize} {x} {y} {content}`	字体、尺寸、坐标、内容、旋转、字符集。	打印文本。	-
`setMag(font)` 打印与版面	`SETMAG {ex} {ey}`	font: 字体枚举。	设置字体放大倍率。	TypeScript SDK 暴露。
`bold(enable)` 打印与版面	`SETBOLD 1\|0`	enable: 是否加粗。	设置加粗。	-
`underline(enable)` 打印与版面	`UNDERLINE ON\|OFF`	enable: 是否下划线。	设置下划线。	-
`waterMark(value) / watermark(value)` 打印与版面	`WM {value} / WAT {value}`	value: 水印强度或参数。	设置水印。	Java 使用 WM，TypeScript 使用 WAT。
`line(...)` 打印与版面	`LINE ... / LPLINE ... / L ... / LP ...`	起止点、线宽、是否虚线。	绘制直线。	不同 SDK 使用长短前缀。
`box(...)` 打印与版面	`BOX {x1} {y1} {x2} {y2} {width}`	矩形范围和线宽。	绘制矩形。	-
`inverse(...) / inverseLine(...)` 打印与版面	`INVERSE-LINE {x1} {y1} {x2} {y2} {height}`	反显区域。	绘制反显区域。	-
`barcode(...)` 打印与版面	`{rotation} {type} {width} {ratio} {height} {x} {y} {value}`	条码类型、宽度、比例、高度、坐标、内容。	打印一维条码。	-
`qrcode(...)` 打印与版面	`SETQRVER ... + QR ... + {level}A,{content} + ENDQR`	坐标、内容、宽度、纠错等级、旋转。	打印二维码。	-
`image(...)` 图片与图形	`CG {byteWidth} {height} {x} {y} {bitmap} / ZG {byteWidth} {height} {xByte} {y} {len} {bitmap}`	图片、坐标、阈值、反色、压缩。	发送 CPCL 位图。	-
`form()` 打印与版面	`FORM`	-	结束页面内容并准备打印。	-
`print(mode)` 打印与版面	`PRINT / POPRINT`	mode: 普通或横向。	触发打印。	-
`status()` 状态查询	`! U1 STATUS / 10 04 05`	-	查询状态。	Java 输出文本状态查询；TypeScript 当前输出实时状态 bytes。
`realtimeStatus()` 状态查询	`10 04 05`	-	查询实时状态。	Java SDK 暴露。
`querySerialNumber()` 设备信息	`10 FF EF F2`	-	二进制查询序列号。	Java SDK 暴露。
`sn()` 设备信息	`! U1 SN`	-	文本查询序列号。	Java SDK 暴露。
`queryModel()` 设备信息	`10 FF EF F0`	-	二进制查询型号。	Java SDK 暴露。
`model()` 设备信息	`! U1 MODEL`	-	文本查询型号。	Java SDK 暴露。
`queryVersion()` 设备信息	`10 FF EF F1`	-	二进制查询版本。	Java SDK 暴露。
`version()` 设备信息	`! U1 VERSION`	-	文本查询版本。	Java SDK 暴露。
`queryBatteryLevel() / batteryVolume()` 状态查询	`10 FF EF F3`	-	查询电量。	Java SDK 暴露。
`feed()` 组合方法 / 别名	`! 0 200 200 0 1 + PAGE-WIDTH 576 + GAP-SENSE + FORM + PRINT`	-	组合走纸流程。	-
`raw(...)` 组合方法 / 别名	`调用方提供的 CPCL 文本。`	template/args。	发送未封装的 CPCL 指令。	-