Android设备使用Zebra ZQ5221打印Bitmap乱码，求无官方库解决方案

核心原因 #

Zebra ZQ5221是ZPL指令驱动的打印机，和普通热敏打印机的原始位图打印逻辑不同。你的蓝牙代码在其他打印机能工作，是因为那些打印机支持直接接收原始像素数据，而Zebra需要先把Bitmap转换成ZPL格式的图像指令才能正确解析。

具体实现步骤 #

1. 将Drawable转Bitmap #

先把你的Drawable资源转换成Bitmap，同时适配打印机分辨率：

// 从资源获取Drawable
Drawable drawable = getResources().getDrawable(R.drawable.your_image);
Bitmap bitmap = ((BitmapDrawable) drawable).getBitmap();
// ZQ5221最大打印宽度为480像素（203dpi），按比例缩放
bitmap = Bitmap.createScaledBitmap(bitmap, 480, bitmap.getHeight() * 480 / bitmap.getWidth(), true);

2. 把Bitmap转换成ZPL图像指令 #

ZPL的图像指令格式为^GFA,{总字节数},{总字节数},{每行字节数},{十六进制图像数据}，需要将Bitmap像素打包成符合要求的格式：

public static String bitmapToZpl(Bitmap bitmap) {
    int width = bitmap.getWidth();
    int height = bitmap.getHeight();
    
    // 计算每行所需字节数（每字节对应8个像素，向上取整）
    int bytesPerLine = (width + 7) / 8;
    int totalBytes = bytesPerLine * height;
    
    StringBuilder zpl = new StringBuilder();
    // 初始化打印机，设置标签尺寸
    zpl.append("^XA^LL").append(height).append("^PW").append(width).append("^FS");
    // 插入图像指令头
    zpl.append("^GFA,").append(totalBytes).append(",").append(totalBytes).append(",").append(bytesPerLine).append(",");
    
    // 逐行处理像素，打包成十六进制字节
    for (int y = 0; y < height; y++) {
        StringBuilder lineHex = new StringBuilder();
        for (int x = 0; x < width; x += 8) {
            byte pixelByte = 0;
            // 每8个像素打包为1字节（黑色像素设为1）
            for (int bit = 0; bit < 8; bit++) {
                if (x + bit < width) {
                    int pixel = bitmap.getPixel(x + bit, y);
                    // 灰度阈值判断黑色，可根据图像调整
                    if (Color.red(pixel) < 128 && Color.green(pixel) < 128 && Color.blue(pixel) < 128) {
                        pixelByte |= (1 << (7 - bit));
                    }
                }
            }
            lineHex.append(String.format("%02X", pixelByte));
        }
        zpl.append(lineHex);
    }
    
    // 结束打印指令
    zpl.append("^FS^XZ");
    return zpl.toString();
}

3. 蓝牙发送ZPL指令 #

将生成的ZPL字符串以ISO-8859-1编码转成字节流发送（ZPL默认使用该编码）：

// 假设已获取蓝牙输出流outputStream
String zplData = bitmapToZpl(bitmap);
outputStream.write(zplData.getBytes(StandardCharsets.ISO_8859_1));
outputStream.flush();

关键注意事项 #

• 分辨率适配：ZQ5221的打印分辨率为203dpi，最大打印宽度为480像素，转换Bitmap时需确保宽度不超过该值，避免图像截断。
• 像素阈值：代码中的黑色判断阈值可根据你的图像明暗程度调整，确保背景与内容的区分度。
• 指令完整性：必须以^XA开头、^XZ结尾，中间的^LL（标签高度）和^PW（标签宽度）需与实际图像尺寸匹配，否则打印机可能无法正确解析。

内容的提问来源于stack exchange，提问作者Vishwanath Kumbar