SUNMI端末アプリを開発したい方向け情報まとめ

印刷機能を呼び出す

SUNMI端末の内蔵プリンタの印刷機能を呼び出すには、2つの方法があります。

• Character Printing機能を使う
• ESC/POS instructionを使う

(これらを使う前に、 printerInit() の呼び出しを行って、プリンタの状態 (文字サイズの設定など) をリセットしておきましょう)

Character Printing機能を使う

最も一般的な印刷機能の呼び出し方です。
事前に用意されたメソッドの呼び出し形式で簡単に印刷処理を行うことが出来ます。

Developer DocsのPDF の 1.2.6 で説明されています。

例えば、下記のようなメソッドが用意されています。

void setAlignment(int alignment, ICallback callback)
void setFontSize(float fontsize, ICallback callback)
void printText(String text, ICallback callback)
void printTextWithFont(String text, String typeface, float fontsize, ICallback callback)
void printOriginalText (String text, ICallback callback)

• setAlignmentで左、真ん中、右揃えを変え、
• setFontSizeで文字を大きくし、
• printTextで文字を印刷する

といった形で直感的に使うことが出来ます。

レシートでよくある表組み (商品名、価格、個数を表形式で配置) を印刷するための、 printColumnsText なども用意されています。

同様の呼び出し方で、QRコード、バーコードも簡単に印刷することが出来ます。

void printBarCode(String data, int symbology, int height, int width, int textPosition, ICallback callback)
void printQRCode(String data, int modulesize, int errorlevel, ICallback callback)
void print2DCode(String data, int symbology, int modulesize, int errorlevel, ICallback callback)

別途QRコードの画像を用意したりする必要が無く便利です。

ESC/POS instructionを使う

ESC/POSは、一般的なレシート印刷のためのプロトコルで、SUNMI端末の内蔵プリンタは sendRAWData メソッド経由でこれを受け付ける事が出来ます。
メソッドの名前の通り、ESC/POS命令のバイト列を生で書き込む必要があるため、入力は非常に大変です。

命令セットについて記載したWordファイルがSUNMIから配布されているので、これを参照しながら入力する形になります。

// Instruction: make fonts bold {0x1B, 0x45, 0x1}
woyouService.sendRAWData(newbyte[]{0x1B,0x45,0x1}, callback);
// Instruction: cancel bold {0x1B, 0x45, 0x0}
woyouService.sendRAWData(newbyte[]{0x1B,0x45,0x0}, callback);

void printBitmap(Bitmap bitmap, ICallback callback)
void printBitmapCustom(Bitmap bitmap, int type, ICallbackcallback)