Urovo Pos Printer API
v1.0.6
Urovo Printer SDK (urovoPrinterLib) is a thermal printing library for UROVO POS devices with built-in printers. It supports text, barcodes, QR codes, images, HTML, and label printing. The main entry class is com.urovo.sdk.print.PrinterProviderImpl.
| Item | Detail |
|---|---|
| Version | 1.0.6 |
| Platform | Android |
| Min SDK | API 21 (Android 5.0) |
| Target SDK | API 33 |
| Max paper width | 384 dots (~58 mm thermal paper) |
This document corresponds to SDK release 1.0.6 (urovoPrinterLib_v1.0.6_release.aar).
| Item | Requirement |
|---|---|
| Device | UROVO POS terminal with built-in thermal printer |
| Android | minSdk 21+ |
| Integration | Local AAR (libs/ or flatDir) |
| Storage | READ/WRITE_EXTERNAL_STORAGE; request MANAGE_EXTERNAL_STORAGE on Android 11+ when needed for custom TTF paths |
| Dependencies | Bundled platform_sdk JAR and default font assets/simsun.ttc inside the AAR |
From the release package:
| File | Description |
|---|---|
urovoPrinterLib_v1.0.6_release.aar | Print SDK library |
UrovoPrinterDemoCode.zip | Sample project |
PrinterSdk_v8.*.apk | Installable demo app |
Copy urovoPrinterLib_v1.0.6_release.aar into your app module libs/ folder.
settings.gradle (flatDir example):
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
flatDir { dirs 'libs' }
}
}app/build.gradle:
dependencies {
implementation(name: 'urovoPrinterLib_v1.0.6_release', ext: 'aar')
}Declare in AndroidManifest.xml and request at runtime per target Android version:
| Permission | Purpose |
|---|---|
READ_EXTERNAL_STORAGE / WRITE_EXTERNAL_STORAGE | Read custom TTF fonts, image files, etc. |
MANAGE_EXTERNAL_STORAGE | Android 11+ broad storage access when needed |
-dontwarn com.urovo.**
-keep class com.urovo.** { *; }
-keep interface com.urovo.** { *; }
-dontwarn android.device.**
-keep class android.device.** { *; }
-keep interface android.device.** { *; }
-dontwarn com.google.zxing.**
-keep class com.google.zxing.** { *; }
-dontwarn com.ubx.**
-keep class com.ubx.** { *; }Recommended lifecycle: getInstance → initPrint → add content → startPrint → close. Call close() after each print job and initPrint() before the next. Check getStatus() before printing.
Authentication: None (built-in printer, no API keys).
PrinterProviderImpl.getInstance(context) — obtain instanceinitPrint() — initialize printergetStatus() — confirm status is OK (0x00 / PrintStatus.ERROR_NONE)addText / addImage etc. to build contentfeedLine() — feed paper as neededstartPrint() — submit print; 0x00 means successclose() — release printercom.urovo.sdk.print.PrinterProviderImpl
Main entry class for UROVO POS thermal printing.
Returns the PrinterProviderImpl singleton.
public static PrinterProviderImpl getInstance(Context context)| Name | Type | Description |
|---|---|---|
| context | Context | Application context; prefer getApplicationContext() |
PrinterProviderImpl — singleton instance.
Initializes the printer before each new print job.
public int initPrint()int — 0 (PrintStatus.ERROR_NONE) on success; see PrintStatus for other values.
Returns the current printer status.
public int getStatus()int — status code; see PrintStatus.
| Code | Meaning | Handling |
|---|---|---|
| 0x00 | OK / success | Proceed with printing |
| 0xF0 | Out of paper | Reload paper and retry |
| 0xF3 | Overheat | Wait for cooldown |
| 0xE1 | Low voltage | Check power/battery |
| 0xF7 | Printer busy | Retry later |
| 0xF2 | Hardware error | Inspect device |
| 0xFB | Printer error | Inspect device |
| Other | Print failed | Map via PrintStatus |
Sets print density / grayscale.
public void setGray(int gray)| Name | Type | Description |
|---|---|---|
| gray | int | Grayscale level, range -6 to 6 |
Sets print speed.
public int setSpeed(int speedLevel)| Name | Type | Description |
|---|---|---|
| speedLevel | int | Speed level, range 10–20 |
int — 0 on success; other values on failure.
Adds one line of text with the given format.
public void addText(Bundle format, String text)| Name | Type | Description |
|---|---|---|
| format | Bundle | Keys from PrintFormat: FONT (0 small / 1 normal / 2 large, default 1), FONTBOLD (default false), ALIGN (0 left / 1 center / 2 right), FONTNAME (TTF path), FONTSIZE (overrides FONT when set), LINEHEIGHT |
| text | String | Text to print |
Prints left and right columns on one line (Bundle overload; recommended).
public void addTextLeft_Right(Bundle format, String textLeft, String textRight)| Name | Type | Description |
|---|---|---|
| format | Bundle | Font/alignment keys same as addText |
| textLeft | String | Left text |
| textRight | String | Right text |
Prints left, center, and right columns on one line.
public void addTextLeft_Center_Right(Bundle format, String textLeft, String textCenter, String textRight)| Name | Type | Description |
|---|---|---|
| format | Bundle | Font/alignment keys same as addText |
| textLeft | String | Left column |
| textCenter | String | Center column |
| textRight | String | Right column |
Feeds paper by the given number of lines.
public void feedLine(int lines)| Name | Type | Description |
|---|---|---|
| lines | int | Line count; 0 adds bottom margin; -1 no margin (feed to cutter if supported) |
Adds blank space with the given height.
public void addBlankLine(int height)| Name | Type | Description |
|---|---|---|
| height | int | Blank height |
Adds a black separator line.
public void addBlackLine(int... lineHeight)| Name | Type | Description |
|---|---|---|
| lineHeight | int... | Variable line heights |
Adds a 1D barcode.
public void addBarCode(Bundle format, String barcode)| Name | Type | Description |
|---|---|---|
| format | Bundle | align (0 left / 1 center / 2 right), width, height, PrintFormat.BARCODE_TYPE |
| barcode | String | Barcode payload |
Adds a QR code.
public void addQrCode(Bundle format, String qrCode)| Name | Type | Description |
|---|---|---|
| format | Bundle | align (when offset=-1), offset, expectedHeight |
| qrCode | String | QR payload |
Adds a bitmap from a byte array. Max printable width ~384 dots; width should be ≤ 380.
public void addImage(Bundle format, byte[] imageData)| Name | Type | Description |
|---|---|---|
| format | Bundle | offset (when offset<=0, align applies), width (max ~380), height, align |
| imageData | byte[] | Image bytes (e.g. JPEG) |
Image and text on the same row.
public void addImageWithText(Bundle format, byte[] imageData)| Name | Type | Description |
|---|---|---|
| format | Bundle | align (image), offset, width, height, YAlign (text 0 top / 1 center / 2 bottom), text, font, fontBold, fontName, etc. |
| imageData | byte[] | Image data |
Renders HTML content and prints the result.
public void addHtml(Bundle format, String content)| Name | Type | Description |
|---|---|---|
| format | Bundle | offset, width (max ~380), height |
| content | String | HTML string |
Submits buffered content and starts printing synchronously.
public int startPrint()int — result code; same semantics as getStatus().
| Code | Meaning | Handling |
|---|---|---|
| 0x00 | Success | — |
| 0xF0 | Out of paper | Reload paper |
| 0xF3 | Overheat | Wait for cooldown |
| 0xE1 | Low voltage | Check power |
| 0xF7 | Busy | Retry later |
| 0xF2 | Hardware error | Inspect device |
Releases printer resources; call after each startPrint().
public int close()int — 0 on success.
Returns whether label printing is supported on this device.
public boolean supportLabelPrint()boolean — true if supported.
Switches between receipt mode and label mode.
public boolean setPrinterMode(boolean labelMode)| Name | Type | Description |
|---|---|---|
| labelMode | boolean | true label mode; false normal receipt mode |
boolean — true on success.
Label feed control. Before each label job set PRN_LABEL_LOCATION or PRN_LABEL_CONTINUE; after printing set PRN_LABEL_END.
public int setLabelFeed(byte state)| Name | Type | Description |
|---|---|---|
| state | byte | See PrinterLabelState |
int — 0 on success.
com.urovo.sdk.print.PrintFormat
Bundle keys and alignment/font constants.
| Value | Meaning |
|---|---|
| FONT_SMALL (0) | Small font |
| FONT_NORMAL (1) | Normal font |
| FONT_LARGE (2) | Large font |
| ALIGN_LEFT (0) | Left align |
| ALIGN_CENTER (1) | Center |
| ALIGN_RIGHT (2) | Right align |
| Y_ALIGN_TOP (0) | Text top in image+text layout |
| Y_ALIGN_CENTER (1) | Center |
| Y_ALIGN_BOTTOM (2) | Bottom |
Common keys: FONT, ALIGN, FONTBOLD, FONTNAME, FONTSIZE, LINEHEIGHT, WIDTH, HEIGHT, OFFSET, BARCODE_TYPE, EXHEIGHT.
com.urovo.sdk.print.PrintStatus
| Value | Meaning |
|---|---|
| ERROR_NONE (0x00) | OK / success |
| ERROR_PAPERENDED (0xF0) | Out of paper |
| ERROR_OVERHEAT (0xF3) | Overheat |
| ERROR_LOWVOL (0xE1) | Low voltage |
| ERROR_BUSY (0xF7) | Busy |
| ERROR_HARDERR (0xF2) | Hardware error |
| ERROR_PAPERENDING (0xF4) | Paper low |
| ERROR_BUFOVERFLOW (0xF5) | Buffer overflow |
| ERROR_PAPERJAM (0xEE) | Paper jam |
| ERROR_MOTORERR (0xFB) | Motor error |
Use PrintStatus.getPrinterStatusDes(context, code) for localized descriptions.
com.urovo.sdk.print.PrinterLabelState
| Value | Meaning |
|---|---|
| PRN_LABEL_STUDY (0x00) | Learn label height (not available) |
| PRN_LABEL_LOCATION (0x01) | Label positioning (before each job) |
| PRN_LABEL_CONTINUE (0x02) | Continuous label feed |
| PRN_LABEL_END (0x03) | End label job feed |
Samples from Demo MainActivity.java (com.urovo.print.test). Run printing on a background thread.
PrinterProviderImpl mPrintManager = PrinterProviderImpl.getInstance(context);
mPrintManager.initPrint();
int status = mPrintManager.getStatus();
// status == 0 means printer is ready
mPrintManager.close();Notes: Call initPrint() before query and close() when done; check getStatus() before printing.
PrinterProviderImpl mPrintManager = PrinterProviderImpl.getInstance(context);
new Thread(() -> {
try {
mPrintManager.initPrint();
if (mPrintManager.getStatus() != 0) return;
mPrintManager.setGray(0);
mPrintManager.setSpeed(15);
Bundle format = new Bundle();
byte[] imageData = getBitmapBytes(bitmap);
format.putInt(PrintFormat.ALIGN, PrintFormat.ALIGN_CENTER);
format.putInt(PrintFormat.WIDTH, 196);
format.putInt(PrintFormat.HEIGHT, 58);
mPrintManager.addImage(format, imageData);
format = new Bundle();
format.putInt(PrintFormat.FONT, PrintFormat.FONT_NORMAL);
format.putInt(PrintFormat.ALIGN, PrintFormat.ALIGN_CENTER);
format.putBoolean(PrintFormat.FONTBOLD, true);
mPrintManager.addText(format, "CENTER");
format = new Bundle();
format.putInt(PrintFormat.FONT, PrintFormat.FONT_NORMAL);
mPrintManager.addTextLeft_Right(format, "Item", "$15");
mPrintManager.addTextLeft_Center_Right(format, "Item", "16", "$15");
format = new Bundle();
format.putInt(PrintFormat.ALIGN, PrintFormat.ALIGN_CENTER);
format.putInt(PrintFormat.WIDTH, 300);
format.putInt(PrintFormat.HEIGHT, 100);
mPrintManager.addBarCode(format, "33333333333333");
mPrintManager.feedLine(3);
format = new Bundle();
format.putInt(PrintFormat.ALIGN, PrintFormat.ALIGN_CENTER);
format.putInt(PrintFormat.EXHEIGHT, 100);
mPrintManager.addQrCode(format, "222222222222222222222");
mPrintManager.feedLine(-1);
int iRet = mPrintManager.startPrint();
mPrintManager.close();
} catch (Exception e) {
e.printStackTrace();
}
}).start();Notes: startPrint() blocks; use a worker thread; keep image width ≤ 380.
mPrintManager.initPrint();
if (mPrintManager.getStatus() != 0) return;
mPrintManager.setGray(6);
String content = htmlConvertToString(context, "html_text_document.txt");
Bundle format = new Bundle();
format.putInt(PrintFormat.ALIGN, PrintFormat.ALIGN_CENTER);
format.putInt(PrintFormat.WIDTH, 380);
mPrintManager.addHtml(format, content);
mPrintManager.startPrint();
mPrintManager.close();mPrintManager.initPrint();
if (mPrintManager.getStatus() != 0) return;
if (!mPrintManager.supportLabelPrint()) return;
if (!mPrintManager.setPrinterMode(true)) return;
mPrintManager.setLabelFeed(PrinterLabelState.PRN_LABEL_LOCATION);
mPrintManager.addBlankLine(topMargin);
byte[] imageData = getBitmapBytes(labelBitmap);
Bundle format = new Bundle();
format.putInt(PrintFormat.WIDTH, labelBitmap.getWidth());
format.putInt(PrintFormat.HEIGHT, labelBitmap.getHeight());
mPrintManager.addImage(format, imageData);
mPrintManager.feedLine(-1);
mPrintManager.startPrint();
mPrintManager.setLabelFeed(PrinterLabelState.PRN_LABEL_END);
mPrintManager.close();Notes: Check supportLabelPrint() first; call setLabelFeed(PRN_LABEL_LOCATION) before content; call PRN_LABEL_END after print.
close() after each job; call initPrint() before the next to avoid resource leaks.startPrint() is synchronous; avoid long prints on the main thread.width ≤ 380 recommended.Q: What must I call before printing?
A: getInstance() → initPrint() → check getStatus() → add content → startPrint() → close().
Q: What if startPrint returns non-zero?
A: Map the code via PrintStatus; handle out-of-paper, overheat, or low voltage before retrying.
Q: Is HTML printing supported?
A: Yes, via addHtml(); complex CSS may vary by device.
Q: How do I switch label vs receipt mode?
A: Use supportLabelPrint(), then setPrinterMode(true/false) with setLabelFeed() for label feed control.
Urovo Printer SDK（urovoPrinterLib）面向 UROVO POS 终端内置热敏打印机，提供文本、条码、二维码、图片、HTML 及标签纸打印能力。核心入口类为 com.urovo.sdk.print.PrinterProviderImpl。
| 项目 | 说明 |
|---|---|
| 版本 | 1.0.6 |
| 平台 | Android |
| 最低 SDK | API 21（Android 5.0） |
| 目标 SDK | API 33 |
| 最大纸宽 | 384 点（约 58mm 热敏纸） |
当前文档对应 SDK 1.0.6 发布包（urovoPrinterLib_v1.0.6_release.aar）。
| 项 | 要求 |
|---|---|
| 设备 | UROVO POS 终端（内置热敏打印机） |
| Android | minSdk 21+ |
| 集成方式 | 本地 AAR（libs/ 或 flatDir） |
| 存储权限 | READ/WRITE_EXTERNAL_STORAGE；Android 11+ 按需申请 MANAGE_EXTERNAL_STORAGE（自定义 TTF 字体路径等） |
| 依赖 | AAR 内已打包 platform_sdk JAR 及默认字体 assets/simsun.ttc |
从发布包中获取：
| 文件 | 说明 |
|---|---|
urovoPrinterLib_v1.0.6_release.aar | 打印 SDK 库 |
UrovoPrinterDemoCode.zip | 示例工程 |
PrinterSdk_v8.*.apk | 可安装的 Demo 应用 |
将 urovoPrinterLib_v1.0.6_release.aar 复制到应用模块 libs/ 目录。
settings.gradle（flatDir 示例）：
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
flatDir { dirs 'libs' }
}
}app/build.gradle：
dependencies {
implementation(name: 'urovoPrinterLib_v1.0.6_release', ext: 'aar')
}在 AndroidManifest.xml 中声明并按目标 Android 版本运行时申请：
| 权限 | 用途 |
|---|---|
READ_EXTERNAL_STORAGE / WRITE_EXTERNAL_STORAGE | 读取自定义 TTF 字体、图片文件等 |
MANAGE_EXTERNAL_STORAGE | Android 11+ 访问 broad storage 时按需申请 |
-dontwarn com.urovo.**
-keep class com.urovo.** { *; }
-keep interface com.urovo.** { *; }
-dontwarn android.device.**
-keep class android.device.** { *; }
-keep interface android.device.** { *; }
-dontwarn com.google.zxing.**
-keep class com.google.zxing.** { *; }
-dontwarn com.ubx.**
-keep class com.ubx.** { *; }推荐生命周期：getInstance → initPrint → 组内容 → startPrint → close。每次打印完成后调用 close()，下次打印前再次 initPrint()。打印前建议检查 getStatus() 返回值。
鉴权：无（设备内置打印机，无需额外密钥）。
PrinterProviderImpl.getInstance(context) 获取实例initPrint() 初始化打印机getStatus() 确认状态正常（0x00 / PrintStatus.ERROR_NONE）addText / addImage 等接口组内容feedLine() 按需走纸startPrint() 提交打印；返回 0x00 表示成功close() 关闭打印机com.urovo.sdk.print.PrinterProviderImpl
UROVO POS 热敏打印核心入口类。
获取 PrinterProviderImpl 单例。
public static PrinterProviderImpl getInstance(Context context)| 参数 | 类型 | 说明 |
|---|---|---|
| context | Context | 应用上下文，建议 getApplicationContext() |
PrinterProviderImpl — 单例实例。
初始化打印机；每次新的打印任务开始前调用。
public int initPrint()int — 0（PrintStatus.ERROR_NONE）表示成功，其他值参见 PrintStatus。
获取打印机当前状态。
public int getStatus()int — 打印机状态码，参见 PrintStatus。
| 错误码 | 含义 | 建议处理 |
|---|---|---|
| 0x00 | 正常/成功 | 可继续打印 |
| 0xF0 | 缺纸 | 装纸后重试 |
| 0xF3 | 过热 | 等待冷却后重试 |
| 0xE1 | 低压 | 检查电源/电池 |
| 0xF7 | 打印机忙 | 稍后重试 |
| 0xF2 | 硬件错误 | 检查设备 |
| 0xFB | 打印机错误 | 检查设备 |
| 其他 | 打印失败 | 对照 PrintStatus 处理 |
设置打印灰度/浓度。
public void setGray(int gray)| 参数 | 类型 | 说明 |
|---|---|---|
| gray | int | 灰度等级，范围 -6 ~ 6 |
设置打印速度。
public int setSpeed(int speedLevel)| 参数 | 类型 | 说明 |
|---|---|---|
| speedLevel | int | 速度等级，范围 10–20 |
int — 0 成功；其他失败。
按指定格式添加一行文本。
public void addText(Bundle format, String text)| 参数 | 类型 | 说明 |
|---|---|---|
| format | Bundle | 格式键见 PrintFormat：FONT（0 小/1 中/2 大，默认 1）、FONTBOLD（默认 false）、ALIGN（0 左/1 中/2 右）、FONTNAME（TTF 路径）、FONTSIZE（设置后忽略 FONT）、LINEHEIGHT（行距） |
| text | String | 打印文本 |
左右两列文本一行输出（Bundle 版，推荐使用）。
public void addTextLeft_Right(Bundle format, String textLeft, String textRight)| 参数 | 类型 | 说明 |
|---|---|---|
| format | Bundle | 字体/对齐等，键同 addText |
| textLeft | String | 左侧文本 |
| textRight | String | 右侧文本 |
左、中、右三列文本一行输出。
public void addTextLeft_Center_Right(Bundle format, String textLeft, String textCenter, String textRight)| 参数 | 类型 | 说明 |
|---|---|---|
| format | Bundle | 字体/对齐等，键同 addText |
| textLeft | String | 左列文本 |
| textCenter | String | 中列文本 |
| textRight | String | 右列文本 |
走纸指定行数。
public void feedLine(int lines)| 参数 | 类型 | 说明 |
|---|---|---|
| lines | int | 走纸行数；0 底部留白；-1 不留白（走纸至切刀位，若设备支持） |
添加指定高度的空白行。
public void addBlankLine(int height)| 参数 | 类型 | 说明 |
|---|---|---|
| height | int | 空白高度 |
添加黑色分隔线。
public void addBlackLine(int... lineHeight)| 参数 | 类型 | 说明 |
|---|---|---|
| lineHeight | int... | 各行行高，可变参数 |
添加一维条码。
public void addBarCode(Bundle format, String barcode)| 参数 | 类型 | 说明 |
|---|---|---|
| format | Bundle | align（0 左/1 中/2 右）、width、height、PrintFormat.BARCODE_TYPE（条码类型） |
| barcode | String | 条码内容 |
添加 QR 二维码。
public void addQrCode(Bundle format, String qrCode)| 参数 | 类型 | 说明 |
|---|---|---|
| format | Bundle | align（offset=-1 时生效）、offset（起始位置）、expectedHeight（期望高度） |
| qrCode | String | 二维码内容 |
添加位图（字节数组）。最大打印宽度约 384 点，<code>width</code> 参数建议 ≤ 380。
public void addImage(Bundle format, byte[] imageData)| 参数 | 类型 | 说明 |
|---|---|---|
| format | Bundle | offset（起始位置；offset<=0 时 align 生效）、width（最大约 380）、height、align |
| imageData | byte[] | 图片字节数据（如 JPEG） |
图文混排：图片与文字在同一行区域。
public void addImageWithText(Bundle format, byte[] imageData)| 参数 | 类型 | 说明 |
|---|---|---|
| format | Bundle | align（图片 0 左/1 中/2 右）、offset、width、height、YAlign（文字 0 顶/1 中/2 底）、text、font、fontBold、fontName 等 |
| imageData | byte[] | 图片数据 |
添加 HTML 内容，渲染后打印。
public void addHtml(Bundle format, String content)| 参数 | 类型 | 说明 |
|---|---|---|
| format | Bundle | offset、width（最大约 380）、height |
| content | String | HTML 字符串 |
同步提交缓冲区内容并开始打印。
public int startPrint()int — 打印结果状态码，含义与 getStatus() 一致。
| 错误码 | 含义 | 建议处理 |
|---|---|---|
| 0x00 | 成功 | — |
| 0xF0 | 缺纸 | 装纸后重试 |
| 0xF3 | 过热 | 等待冷却后重试 |
| 0xE1 | 低压 | 检查电源 |
| 0xF7 | 打印机忙 | 稍后重试 |
| 0xF2 | 硬件错误 | 检查设备 |
关闭打印机资源；建议在每次 startPrint() 完成后调用。
public int close()int — 0 表示成功。
查询当前设备是否支持标签打印。
public boolean supportLabelPrint()boolean — true 支持；false 不支持。
切换普通小票模式与标签模式。
public boolean setPrinterMode(boolean labelMode)| 参数 | 类型 | 说明 |
|---|---|---|
| labelMode | boolean | true 标签模式；false 普通模式 |
boolean — true 设置成功；false 失败。
标签走纸控制。每次标签打印前需设置 PRN_LABEL_LOCATION 或 PRN_LABEL_CONTINUE，完成后设置 PRN_LABEL_END。
public int setLabelFeed(byte state)| 参数 | 类型 | 说明 |
|---|---|---|
| state | byte | 见 PrinterLabelState |
int — 0 成功；其他失败。
com.urovo.sdk.print.PrintFormat
PrintFormat 定义 Bundle 格式键与对齐/字体常量。
| 值 | 含义 |
|---|---|
| FONT_SMALL (0) | 小字体 |
| FONT_NORMAL (1) | 正常字体 |
| FONT_LARGE (2) | 大字体 |
| ALIGN_LEFT (0) | 左对齐 |
| ALIGN_CENTER (1) | 居中 |
| ALIGN_RIGHT (2) | 右对齐 |
| Y_ALIGN_TOP (0) | 图文混排文字顶对齐 |
| Y_ALIGN_CENTER (1) | 居中 |
| Y_ALIGN_BOTTOM (2) | 底对齐 |
常用键名：FONT、ALIGN、FONTBOLD、FONTNAME、FONTSIZE、LINEHEIGHT、WIDTH、HEIGHT、OFFSET、BARCODE_TYPE、EXHEIGHT。
com.urovo.sdk.print.PrintStatus
| 值 | 含义 |
|---|---|
| ERROR_NONE (0x00) | 正常/成功 |
| ERROR_PAPERENDED (0xF0) | 缺纸 |
| ERROR_OVERHEAT (0xF3) | 过热 |
| ERROR_LOWVOL (0xE1) | 低压 |
| ERROR_BUSY (0xF7) | 打印机忙 |
| ERROR_HARDERR (0xF2) | 硬件错误 |
| ERROR_PAPERENDING (0xF4) | 纸将尽 |
| ERROR_BUFOVERFLOW (0xF5) | 缓冲区溢出 |
| ERROR_PAPERJAM (0xEE) | 卡纸 |
| ERROR_MOTORERR (0xFB) | 马达错误 |
可通过 PrintStatus.getPrinterStatusDes(context, code) 获取本地化描述。
com.urovo.sdk.print.PrinterLabelState
| 值 | 含义 |
|---|---|
| PRN_LABEL_STUDY (0x00) | 学习标签高度（当前不可用） |
| PRN_LABEL_LOCATION (0x01) | 标签定位（单次/多次打印前） |
| PRN_LABEL_CONTINUE (0x02) | 标签连续打印 |
| PRN_LABEL_END (0x03) | 标签打印结束走纸 |
以下示例摘自 Demo 工程 MainActivity.java（com.urovo.print.test）。打印逻辑在后台线程执行，避免阻塞 UI。
PrinterProviderImpl mPrintManager = PrinterProviderImpl.getInstance(context);
mPrintManager.initPrint();
int status = mPrintManager.getStatus();
// status == 0 表示打印机正常
mPrintManager.close();要点： 每次查询前需 initPrint()，结束后 close()；打印前建议同样检查 getStatus()。
PrinterProviderImpl mPrintManager = PrinterProviderImpl.getInstance(context);
new Thread(() -> {
try {
mPrintManager.initPrint();
if (mPrintManager.getStatus() != 0) return;
mPrintManager.setGray(0);
mPrintManager.setSpeed(15);
Bundle format = new Bundle();
byte[] imageData = getBitmapBytes(bitmap);
format.putInt(PrintFormat.ALIGN, PrintFormat.ALIGN_CENTER);
format.putInt(PrintFormat.WIDTH, 196);
format.putInt(PrintFormat.HEIGHT, 58);
mPrintManager.addImage(format, imageData);
format = new Bundle();
format.putInt(PrintFormat.FONT, PrintFormat.FONT_NORMAL);
format.putInt(PrintFormat.ALIGN, PrintFormat.ALIGN_CENTER);
format.putBoolean(PrintFormat.FONTBOLD, true);
mPrintManager.addText(format, "CENTER");
format = new Bundle();
format.putInt(PrintFormat.FONT, PrintFormat.FONT_NORMAL);
mPrintManager.addTextLeft_Right(format, "健力宝", "15元");
mPrintManager.addTextLeft_Center_Right(format, "健力宝", "16", "15元");
format = new Bundle();
format.putInt(PrintFormat.ALIGN, PrintFormat.ALIGN_CENTER);
format.putInt(PrintFormat.WIDTH, 300);
format.putInt(PrintFormat.HEIGHT, 100);
mPrintManager.addBarCode(format, "33333333333333");
mPrintManager.feedLine(3);
format = new Bundle();
format.putInt(PrintFormat.ALIGN, PrintFormat.ALIGN_CENTER);
format.putInt(PrintFormat.EXHEIGHT, 100);
mPrintManager.addQrCode(format, "222222222222222222222");
mPrintManager.feedLine(-1);
int iRet = mPrintManager.startPrint();
mPrintManager.close();
} catch (Exception e) {
e.printStackTrace();
}
}).start();要点： startPrint() 为同步阻塞调用，须在后台线程执行；图片 width 建议 ≤ 380。
mPrintManager.initPrint();
if (mPrintManager.getStatus() != 0) return;
mPrintManager.setGray(6);
String content = htmlConvertToString(context, "html_text_document.txt");
Bundle format = new Bundle();
format.putInt(PrintFormat.ALIGN, PrintFormat.ALIGN_CENTER);
format.putInt(PrintFormat.WIDTH, 380);
mPrintManager.addHtml(format, content);
mPrintManager.startPrint();
mPrintManager.close();mPrintManager.initPrint();
if (mPrintManager.getStatus() != 0) return;
if (!mPrintManager.supportLabelPrint()) return;
if (!mPrintManager.setPrinterMode(true)) return;
mPrintManager.setLabelFeed(PrinterLabelState.PRN_LABEL_LOCATION);
mPrintManager.addBlankLine(topMargin);
byte[] imageData = getBitmapBytes(labelBitmap);
Bundle format = new Bundle();
format.putInt(PrintFormat.WIDTH, labelBitmap.getWidth());
format.putInt(PrintFormat.HEIGHT, labelBitmap.getHeight());
mPrintManager.addImage(format, imageData);
mPrintManager.feedLine(-1);
mPrintManager.startPrint();
mPrintManager.setLabelFeed(PrinterLabelState.PRN_LABEL_END);
mPrintManager.close();要点： 先 supportLabelPrint() 判断能力；setLabelFeed(PRN_LABEL_LOCATION) 在添加内容前调用；打印结束后调用 PRN_LABEL_END。
close()，下次再 initPrint()，避免资源占用与状态错乱。startPrint() 为同步调用，不宜在主线程执行长时间打印。width 建议 ≤ 380。Q: 打印前必须调用哪些方法？
A: getInstance() → initPrint() → 检查 getStatus() → 添加内容 → startPrint() → close()。
Q: startPrint 返回非 0 怎么办？
A: 对照 PrintStatus 错误码处理；缺纸/过热/低压需人工干预后重试。
Q: 是否支持 HTML 打印？
A: 支持，使用 addHtml()；复杂 CSS 渲染效果以实机为准。
Q: 标签纸与普通小票如何切换？
A: supportLabelPrint() 判断能力后，setPrinterMode(true/false) 切换，并配合 setLabelFeed() 控制走纸。