兼容ESC/POS指令的打印场景如何增大输出QR码的尺寸

问题根因 #

当前代码打印的QR码偏小，核心原因是未在发送QR码内容指令前配置单模块宽度参数。代码中定义的SET_BAR_CODE_HEIGHT仅对一维条形码生效，完全不影响QR码的最终打印尺寸。

调整方法 #

• 引入QR码模块宽度设置指令：标准ESC/POS协议中，QR码模块宽度的控制指令为 0x1D 0x28 0x6B 0x03 0x00 0x31 0x43 <n>
  • 参数<n>代表QR码中单个正方形模块的打印点数量，打印机默认值通常为2，对应你当前看到的小尺寸效果
  • 合法取值范围一般为2~16，可匹配不同纸宽选择参数：
    • 58mm 窄幅收银纸：推荐n取4~6
    • 80mm 标准收银纸：推荐n取6~8，即可达到需要的大尺寸QR码效果
• 严格遵循指令发送顺序：必须先发送模块尺寸设置指令，再发送QR码内容生成指令，否则参数无法生效

代码修改示例 #

在原有打印逻辑基础上插入尺寸配置指令，调整后的核心代码段：

byte[] INIT = {27, 64};
byte[] FEED_LINE = {10};
byte[] SELECT_FONT_A = {27, 33, 0};
byte[] ALLINEA_CT = {0x1B, 0x61, 0x01};
byte[] ALLINEA_SELECT = {0x1b, 0x3d, 0x01};
byte[] FONT_1X = {0x1D, 0x21, 0x00};
// 新增：设置QR码单模块宽度为6，可根据实际纸宽调整数值
byte[] SET_QR_MODULE_SIZE = {0x1D, 0x28, 0x6B, 0x03, 0x00, 0x31, 0x43, 6};

OutputStream oStream = sock.getOutputStream();
oStream.write(INIT);
oStream.write(ALLINEA_CT);
// 紧邻QR指令前发送尺寸设置，确保参数被正确识别
oStream.write(SET_QR_MODULE_SIZE);
oStream.write(ALLINEA_SELECT);
oStream.write(command); // 原有QR码内容生成指令
oStream.write(FEED_LINE);

oStream.write(ALLINEA_CT);
oStream.write(SELECT_FONT_A);
oStream.write(FONT_1X);
oStream.write("TABLE : ".getBytes());
oStream.write(strTable.getBytes());
oStream.write(FEED_LINE);

oStream.write(new byte[]{0x1D, 0x56, 0x41, 0x10});
oStream.flush();
oStream.close();

注意事项 #

• 选择n值时需匹配打印纸有效可打印宽度，避免n值过大导致QR码右侧截断，无法正常扫描
• 部分老旧兼容打印机对指令时序有要求，设置尺寸的指令必须紧邻QR码内容指令发送，中间不要穿插其他无关指令，否则可能不识别尺寸参数
• 原代码中的SET_BAR_CODE_HEIGHT为一维条形码专用配置，对QR码无实际作用，可直接删除减少无效传输

内容的提问来源于stack exchange，提问作者Arnold Brown