How to Print Unsupported Character Sets with a POS Printer
The printer of the POS support GB2312 character set by default, and it also support some Latin character (ISO8859-1,...). But it depends on the POS model. Developer can use ESC command to change the codepage, please refer to here: http://sdkwiki.wizarpos.com/index.php/ESC_Commands#ESC_t
But if you find the above information still can not make you print correct character, or you want more beautiful font, you can try to use HTML content printing. These section will tell you how to print receipt by HTML.
Please add WebView.enableSlowWholeDocumentDraw() in your APP source code, because we use android WebView to print html content.
Permission
The app declares the android.permission.SYSTEM_ALERT_WINDOW in the manifest. This is required by printHTML utility to use a hidden HTML rendering window.
By Java API
Please refer to java API Spec. in APIDemoForAar from SDK folder \cloudpos_SDK\device\apidemo\, there is a printHtml method in com.wizarpos.apidemo.action.PrinterAction.java, you can call it like this.
By JNI API
API Overview
PrintHtmlInterface.printHTML
void printHTML(Context context, String htmlcontent, PrinterHtmlListener listener);
Print HTML content.
Returns | |
---|---|
context | Context : The activity or application context of the APP. It's used by method to create the hidden window. |
htmlcontent | String : The HTML content for printing. |
listener | PrinterHtmlListener : the callback listener to process the print result, Not null. |
PrintHtmlInterface.convert2Image
void convert2Image(Context context, String htmlContent, PrinterHtmlListener listener);
Convert the html content to a image, if want print, please call print API of the printer.
Returns | |
---|---|
context | Context : The activity or application context of the APP, Not null. |
htmlcontent | String : The html content, Not null. |
listener | PrinterHtmlListener : the callback listener to process the print result, Not null. |
PrinterHtmlListener.onGet
void onGet(Bitmap returbitmap, int result);
This callback will return the bitmap if you invoke the convert2Image method of the PrintHtmlInterface.
Returns | |
---|---|
returbitmap | Bitmap : The returned bitmap. |
result | int: The result of get image, "2:" BITMAP_ERROR, "3:" BITMAP_SUCCESS. |
PrinterHtmlListener.onFinishPrinting
void onFinishPrinting(int result);
This callback will be callled after printing if you invoke the printHTML method of the PrintHtmlInterface.
Returns | |
---|---|
result | int : The result of the print,"0:" PRINT_ERROR, "1:" PRINT_SUCCESS,"2:" BITMAP_ERROR, "3:" BITMAP_SUCCESS,"4:" DEVICE_NOT_OPEN. |
Sample
Please find the sample in SDK folder, apidemo