手機小票打印軟件，Android打印機--小票打印格式及模板設置
手機小票打印軟件，Android打印機--小票打印格式及模板設置
小票打印就是向打印設備發送控制打印格式的指令集，而這些打印格式需要去查詢對應打印機的API文檔，這里我把常用的api給封裝了一下
- 文字對齊方式
- 打印字體大小
- 字體是否加粗
- 打印二維碼
- 打印條形碼
- 切紙
- 打開錢箱
- 字符串轉字節數組
- 字符拼接
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=140byte[] 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=141byte[] 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=142byte[] 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…dkbyte[] 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=144byte[] 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);