Android打印机--小票打印格式及模板设置实例代码

发布时间 - 2026-01-11 00:33:45    点击率:

小票打印就是向打印设备发送控制打印格式的指令集,而这些打印格式需要去查询对应打印机的API文档,这里我把常用的api给封装了一下

  1. 文字对齐方式
  2. 打印字体大小
  3. 字体是否加粗
  4. 打印二维码
  5. 打印条形码
  6. 切纸
  7. 打开钱箱
  8. 字符串转字节数组
  9. 字符拼接

PrintFormatUtils.Java

/**
 * 打印格式
 * Created by john on 17-3-23.
 */

public class PrintFormatUtils {
  // 对齐方式
  public static final int ALIGN_LEFT = 0;   // 靠左
  public static final int ALIGN_CENTER = 1;  // 居中
  public static final int ALIGN_RIGHT = 2;  // 靠右

  //字体大小
  public static final int FONT_NORMAL = 0;  // 正常
  public static final int FONT_MIDDLE = 1;  // 中等
  public static final int FONT_BIG = 2;    // 大

  //加粗模式
  public static final int FONT_BOLD = 0;       // 字体加粗
  public static final int FONT_BOLD_CANCEL = 1;    // 取消加粗

  /**
   * 打印二维码
   * @param qrCode
   * @return
   */
  public static String getQrCodeCmd(String qrCode) {
    byte[] data;
    int store_len = qrCode.length() + 3;
    byte store_pL = (byte) (store_len % 256);
    byte store_pH = (byte) (store_len / 256);

    // QR Code: Select the model
    //       Hex   1D   28   6B   04   00   31   41   n1(x32)   n2(x00) - size of model
    // set n1 [49 x31, model 1] [50 x32, model 2] [51 x33, micro qr code]
    // https://reference.epson-biz.com/modules/ref_escpos/index.php?content_id=140
    byte[] modelQR = {(byte)0x1d, (byte)0x28, (byte)0x6b, (byte)0x04, (byte)0x00, (byte)0x31, (byte)0x41, (byte)0x32, (byte)0x00};

    // QR Code: Set the size of module
    // Hex   1D   28   6B   03   00   31   43   n
    // n depends on the printer
    // https://reference.epson-biz.com/modules/ref_escpos/index.php?content_id=141
    byte[] sizeQR = {(byte)0x1d, (byte)0x28, (byte)0x6b, (byte)0x03, (byte)0x00, (byte)0x31, (byte)0x43, (byte)0x08};

    //     Hex   1D   28   6B   03   00   31   45   n
    // Set n for error correction [48 x30 -> 7%] [49 x31-> 15%] [50 x32 -> 25%] [51 x33 -> 30%]
    // https://reference.epson-biz.com/modules/ref_escpos/index.php?content_id=142
    byte[] errorQR = {(byte)0x1d, (byte)0x28, (byte)0x6b, (byte)0x03, (byte)0x00, (byte)0x31, (byte)0x45, (byte)0x31};

    // QR Code: Store the data in the symbol storage area
    // Hex   1D   28   6B   pL   pH   31   50   30   d1...dk
    // https://reference.epson-biz.com/modules/ref_escpos/index.php?content_id=143
    //            1D     28     6B     pL     pH cn(49->x31) fn(80->x50) m(48->x30) d1…dk
    byte[] storeQR = {(byte)0x1d, (byte)0x28, (byte)0x6b, store_pL, store_pH, (byte)0x31, (byte)0x50, (byte)0x30};

    // QR Code: Print the symbol data in the symbol storage area
    // Hex   1D   28   6B   03   00   31   51   m
    // https://reference.epson-biz.com/modules/ref_escpos/index.php?content_id=144
    byte[] printQR = {(byte)0x1d, (byte)0x28, (byte)0x6b, (byte)0x03, (byte)0x00, (byte)0x31, (byte)0x51, (byte)0x30};

    data = byteMerger(modelQR, sizeQR);
    data = byteMerger(data, errorQR);
    data = byteMerger(data, storeQR);
    data = byteMerger(data, qrCode.getBytes());
    data = byteMerger(data, printQR);

    return new String(data);
  }

  /**
   * 打印条码
   * @param barcode
   * @return
   */
  public static String getBarcodeCmd(String barcode) {
    // 打印 Code-128 条码时需要使用字符集前缀
    // "{A" 表示大写字母
    // "{B" 表示所有字母,数字,符号
    // "{C" 表示数字,可以表示 00 - 99 的范围


    byte[] data;

    String btEncode;

    if (barcode.length() < 18) {
      // 字符长度小于15的时候直接输出字符串
      btEncode = "{B" + barcode;
    } else {
      // 否则做一点优化

      int startPos = 0;
      btEncode = "{B";

      for (int i = 0; i < barcode.length(); i++) {
        char curChar = barcode.charAt(i);

        if (curChar < 48 || curChar > 57 || i == (barcode.length() - 1)) {
          // 如果是非数字或者是最后一个字符

          if (i - startPos >= 10) {
            if (startPos == 0) {
              btEncode = "";
            }

            btEncode += "{C";

            boolean isFirst = true;
            int numCode = 0;

            for (int j = startPos; j < i; j++) {

              if (isFirst) { // 处理第一位
                numCode = (barcode.charAt(j) - 48) * 10;
                isFirst = false;
              } else { // 处理第二位
                numCode += (barcode.charAt(j) - 48);
                btEncode += (char) numCode;
                isFirst = true;
              }

            }

            btEncode += "{B";

            if (!isFirst) {
              startPos = i - 1;
            } else {
              startPos = i;
            }
          }

          for (int k = startPos; k <= i; k++) {
            btEncode += barcode.charAt(k);
          }
          startPos = i + 1;
        }

      }
    }


    // 设置 HRI 的位置,02 表示下方
    byte[] hriPosition = {(byte) 0x1d, (byte) 0x48, (byte) 0x02};
    // 最后一个参数表示宽度 取值范围 1-6 如果条码超长则无法打印
    byte[] width = {(byte) 0x1d, (byte) 0x77, (byte) 0x02};
    byte[] height = {(byte) 0x1d, (byte) 0x68, (byte) 0xfe};
    // 最后两个参数 73 : CODE 128 || 编码的长度
    byte[] barcodeType = {(byte) 0x1d, (byte) 0x6b, (byte) 73, (byte) btEncode.length()};
    byte[] print = {(byte) 10, (byte) 0};

    data = PrintFormatUtils.byteMerger(hriPosition, width);
    data = PrintFormatUtils.byteMerger(data, height);
    data = PrintFormatUtils.byteMerger(data, barcodeType);
    data = PrintFormatUtils.byteMerger(data, btEncode.getBytes());
    data = PrintFormatUtils.byteMerger(data, print);

    return new String(data);
  }

  /**
   * 切纸
   * @return
   */
  public static String getCutPaperCmd() {
    // 走纸并切纸,最后一个参数控制走纸的长度
    byte[] data = {(byte) 0x1d, (byte) 0x56, (byte) 0x42, (byte) 0x15};

    return new String(data);
  }

  /**
   * 对齐方式
   * @param alignMode
   * @return
   */
  public static String getAlignCmd(int alignMode) {
    byte[] data = {(byte) 0x1b, (byte) 0x61, (byte) 0x0};
    if (alignMode == ALIGN_LEFT) {
      data[2] = (byte) 0x00;
    } else if (alignMode == ALIGN_CENTER) {
      data[2] = (byte) 0x01;
    } else if (alignMode == ALIGN_RIGHT) {
      data[2] = (byte) 0x02;
    }

    return new String(data);
  }

  /**
   * 字体大小
   * @param fontSize
   * @return
   */
  public static String getFontSizeCmd(int fontSize) {
    byte[] data = {(byte) 0x1d, (byte) 0x21, (byte) 0x0};
    if (fontSize == FONT_NORMAL) {
      data[2] = (byte) 0x00;
    } else if (fontSize == FONT_MIDDLE) {
      data[2] = (byte) 0x01;
    } else if (fontSize == FONT_BIG) {
      data[2] = (byte) 0x11;
    }

    return new String(data);
  }

  /**
   * 加粗模式
   * @param fontBold
   * @return
   */
  public static String getFontBoldCmd(int fontBold) {
    byte[] data = {(byte) 0x1b, (byte) 0x45, (byte) 0x0};

    if (fontBold == FONT_BOLD) {
      data[2] = (byte) 0x01;
    } else if (fontBold == FONT_BOLD_CANCEL) {
      data[2] = (byte) 0x00;
    }

    return new String(data);
  }

  /**
   * 打开钱箱
   * @return
   */
  public static String getOpenDrawerCmd() {
    byte[] data = new byte[4];
    data[0] = 0x10;
    data[1] = 0x14;
    data[2] = 0x00;
    data[3] = 0x00;

    return new String(data);
  }

  /**
   * 字符串转字节数组
   * @param str
   * @return
   */
  public static byte[] stringToBytes(String str) {
    byte[] data = null;

    try {
      byte[] strBytes = str.getBytes("utf-8");

      data = (new String(strBytes, "utf-8")).getBytes("gbk");
    } catch (UnsupportedEncodingException exception) {
      exception.printStackTrace();
    }

    return data;
  }

  /**
   * 字节数组合并
   * @param bytesA
   * @param bytesB
   * @return
   */
  public static byte[] byteMerger(byte[] bytesA, byte[] bytesB) {
    byte[] bytes = new byte[bytesA.length + bytesB.length];
    System.arraycopy(bytesA, 0, bytes, 0, bytesA.length);
    System.arraycopy(bytesB, 0, bytes, bytesA.length, bytesB.length);
    return bytes;
  }
}

有了打印格式,还要对具体的打印小票设置打印模板,主要就是利用上面的打印格式工具类,进行字符或字符串拼接,设置文字间空格的长度,以及使用换行符换行等。

有些小票打印的内容有可能是通用的,比如底部结束语–可能是公司宣传语或广告语,这些内容是否展示需要根据具体需求加以控制,还有二维码、条形码打印,是否切纸等需要根据实际场景取舍,所以最好封装一个打印配置类,以控制打印内容显示。

/**
 * 打印模板
 */
public class PrintContract {

  /**
   * 打印内容
   */
  public static StringBuilder createXxTxt(String ...) {

    StringBuilder builder = new StringBuilder();

    //设置大号字体以及加粗
    builder.append(PrintFormatUtils.getFontSizeCmd(PrintFormatUtils.FONT_BIG));
    builder.append(PrintFormatUtils.getFontBoldCmd(PrintFormatUtils.FONT_BOLD));

    // 标题
    builder.append("Title");
    //换行,调用次数根据换行数来控制
    addLineSeparator(builder);

    //设置普通字体大小、不加粗
    builder.append(PrintFormatUtils.getFontSizeCmd(PrintFormatUtils.FONT_NORMAL));
    builder.append(PrintFormatUtils.getFontBoldCmd(PrintFormatUtils.FONT_BOLD_CANCEL));

    //内容
    ......

    //设置某两列文字间空格数, x需要计算出来
    addIdenticalStrToStringBuilder(builder, x, " ");

    //切纸
    builder.append(PrintFormatUtils.getCutPaperCmd());

    return builder;
  }

  /**
   * 向StringBuilder中添加指定数量的相同字符
   *
   * @param printCount  添加的字符数量
   * @param identicalStr 添加的字符
   */

  private static void addIdenticalStrToStringBuilder(StringBuilder builder, int printCount, String identicalStr) {
    for (int i = 0; i < printCount; i++) {
      builder.append(identicalStr);
    }
  }

  /**
   * 根据字符串截取前指定字节数,按照GBK编码进行截取
   *
   * @param str 原字符串
   * @param len 截取的字节数
   * @return 截取后的字符串
   */
  private static String subStringByGBK(String str, int len) {
    String result = null;
    if (str != null) {
      try {
        byte[] a = str.getBytes("GBK");
        if (a.length <= len) {
          result = str;
        } else if (len > 0) {
          result = new String(a, 0, len, "GBK");
          int length = result.length();
          if (str.charAt(length - 1) != result.charAt(length - 1)) {
            if (length < 2) {
              result = null;
            } else {
              result = result.substring(0, length - 1);
            }
          }
        }
      } catch (Exception e) {
        e.printStackTrace();
      }
    }
    return result;
  }

  /**
   * 添加换行符
   */
  private static void addLineSeparator(StringBuilder builder) {
    builder.append("\n");
  }

  /**
   * 在GBK编码下,获取其字符串占据的字符个数
   */
  private static int getCharCountByGBKEncoding(String text) {
    try {
      return text.getBytes("GBK").length;
    } catch (Exception e) {
      e.printStackTrace();
      return 0;
    }
  }


  /**
  * 打印相关配置
  */
  public static class PrintConfig {
    public int maxLength = 30;

    public boolean printBarcode = false; // 打印条码
    public boolean printQrCode = false;  // 打印二维码
    public boolean printEndText = true;  // 打印结束语
    public boolean needCutPaper = false; // 是否切纸
  }

}

有了打印模板,接下来就是调用打印设备打印方法发送打印指令

//调用打印机打印方法,传入上面某个小票打印模板返回的字符串
String str = PrintContract.createXxTxt(...);
printer.print(str, null);

//打开钱箱方法
printer.print(PrintFormatUtils.getOpenDrawerCmd(), null);

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。


# android  # 小票打印机  # 打印小票  # Android实现PDF预览打印功能  # Android gradle插件打印时间戳的方法详解  # Android编程实现计算两个日期之间天数并打印所有日期的方法  # Android中如何安全地打印日志详解  # Mac 下 Android Studio 不打印日志的解决办法  # Android jni调试打印char阵列的实例详解  # Android下的POS打印机调用的简单实现  # Android 蓝牙连接 ESC/POS 热敏打印机打印实例(ESC/POS指令篇)  # Android 蓝牙连接 ESC/POS 热敏打印机打印实例(蓝牙连接篇)  # Android进阶——安卓调用ESC/POS打印机打印实例  # Android手机通过蓝牙连接佳博打印机的实例代码  # Android实现系统打印功能  # 加粗  # 小票  # 换行  # 换行符  # 有可能  # 我把  # 或者是  # 要对  # 装了  # 要使  # 大家多多  # 时需  # 行数  # 指令集  # 宣传语  # 文档  # 打印机打印  # index  # ref_escpos  # epson 


相关栏目: 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571


相关推荐: 北京企业网站设计制作公司,北京铁路集团官方网站?  Laravel Debugbar怎么安装_Laravel调试工具栏配置指南  学生网站制作软件,一个12岁的学生写小说,应该去什么样的网站?  为什么php本地部署后css不生效_静态资源加载失败修复技巧【技巧】  Swift开发中switch语句值绑定模式  使用豆包 AI 辅助进行简单网页 HTML 结构设计  BootStrap整体框架之基础布局组件  HTML5段落标签p和br怎么选_文本排版常用标签对比【解答】  Java类加载基本过程详细介绍  Laravel如何实现多对多模型关联?(Eloquent教程)  如何实现javascript表单验证_正则表达式有哪些实用技巧  Windows10如何删除恢复分区_Win10 Diskpart命令强制删除分区  如何在万网开始建站?分步指南解析  JavaScript如何实现继承_有哪些常用方法  哪家制作企业网站好,开办像阿里巴巴那样的网络公司和网站要怎么做?  微信小程序 canvas开发实例及注意事项  Win11怎么恢复误删照片_Win11数据恢复工具使用【推荐】  百度浏览器网页无法复制文字怎么办 百度浏览器复制修复  LinuxShell函数封装方法_脚本复用设计思路【教程】  JavaScript Ajax实现异步通信  如何用已有域名快速搭建网站?  无锡营销型网站制作公司,无锡网选车牌流程?  制作无缝贴图网站有哪些,3dmax无缝贴图怎么调?  如何用AI帮你把自己的生活经历写成一个有趣的故事?  Laravel如何使用Socialite实现第三方登录?(微信/GitHub示例)  大连网站制作公司哪家好一点,大连买房网站哪个好?  Laravel如何处理和验证JSON类型的数据库字段  米侠浏览器网页图片不显示怎么办 米侠图片加载修复  头像制作网站在线观看,除了站酷,还有哪些比较好的设计网站?  如何在不使用负向后查找的情况下匹配特定条件前的换行符  用v-html解决Vue.js渲染中html标签不被解析的问题  Laravel怎么处理异常_Laravel自定义异常处理与错误页面教程  js实现获取鼠标当前的位置  php 三元运算符实例详细介绍  Laravel如何使用Seeder填充数据_Laravel模型工厂Factory批量生成测试数据【方法】  html5源代码发行怎么设置权限_访问权限控制方法与实践【指南】  Laravel Admin后台管理框架推荐_Laravel快速开发后台工具  如何用PHP工具快速搭建高效网站?  开心动漫网站制作软件下载,十分开心动画为何停播?  如何制作一个表白网站视频,关于勇敢表白的小标题?  企业网站制作这些问题要关注  Laravel如何实现全文搜索_Laravel Scout集成Algolia或Meilisearch教程  免费网站制作appp,免费制作app哪个平台好?  打开php文件提示内存不足_怎么调整php内存限制【解决方案】  Java Adapter 适配器模式(类适配器,对象适配器)优缺点对比  Laravel怎么实现软删除SoftDeletes_Laravel模型回收站功能与数据恢复【步骤】  如何正确下载安装西数主机建站助手?  如何在阿里云虚拟主机上快速搭建个人网站?  网站图片在线制作软件,怎么在图片上做链接?  Claude怎样写结构化提示词_Claude结构化提示词写法【教程】