Gprinter Android SDK V1.0使用説明

8199 ワード

Gprinter Android SDKは、佳博ユーザーがより迅速で、より効率的にAndroidプラットフォームの下で佳博プリンタを開発し、使用することを目的としています.SDKで問題が発生したり、バグが見つかったりした場合は、メッセージを残してください
一、GprinterSDKをダウンロードする
GprinterSDKは、佳博プリンタの公式サイトでGprinterSDKをダウンロードしたり、カスタマーサービス担当者に連絡したりしてダウンロードすることができます.
一、gprinter.JArプロジェクトへのインポート
eclipseでgprinter.JArはプロジェクトのlibsフォルダの下にコピーします.
二、プリンタとの通信を確立する
1、デバイスのオブジェクトを取得する
GpDevice mDevice = new GpDevice();

2.受信データコールバック関数を登録する(このインタフェースはデータを受信するためのものである)
mDevice.registerCallback(this);

3、ブルートゥース、USB、ネットポートを開く
Bluetooth通信:
a、AndroidManifestでBluetoothの操作権限を取得する必要がある.xmlに、次のコードを追加します.
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />

<uses-permission android:name="android.permission.BLUETOOTH" />  

b、ブルートゥースを呼び出してAPIを開く
mDevice.openBluetoothPort(Context context,String addr);


contextはコンテキストで、addrはBluetoothアドレスです.例えば、Bluetoothアドレスが「98:D 3:31:40:27:D 7」の場合、
mDevice.openBluetoothPort(MainActivity.this,"98:D3:31:40:27:D7");

USB通信
a、AndroidManifestでUSB操作権限を取得する必要がある.xmlに、次のコードを追加します.
<uses-feature android:name="android.hardware.usb.host" />

b、USBデバイスを登録してブロードキャストを挿入し、抜いて、AndroidManifestにある.xmlに、次のコードを追加します.
 <intent-filter>

     <action android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED" />

 </intent-filter>

 <intent-filter>

      <action android:name="android.hardware.usb.action.USB_DEVICE_DETACHED" />

 </intent-filter>

 <meta-data android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED" android:resource="@xml/device_filter" />

 <meta-data android:name="android.hardware.usb.action.USB_DEVICE_DETACHED" android:resource="@xml/device_filter" />    

c、device_filter.xmlはUSBデバイスのためにファイルを濾過して、中はUSBデバイスのPIDとVID番号を記憶して、一致するデバイスのUSBが挿入するだけあって、やっとUSBが挿入してあるいは放送を抜くことを生むことができて、device_filter.xmlはres/xmlフォルダの下に置く必要があります.ファイル形式は以下の通りです.例えば、Gp 2120 TLラベルプリンタVIDは26728 PIDは1280です.
<?xml version="1.0" encoding="utf-8"?><resources>   

    <usb-device vendor-id="26728" product-id="1280" />

</resources>

d、旧版のAndroid SDKではUSBhostはサポートされておらず、最小SDKバージョンは12なので加入が必要です
android:minSdkVersion="12"

e、USBポートを呼び出してAPIを開く
mDevice.openBluetoothPort(MainActivity.this);

ネットワークポートつうしん
a、AndroidManifestでネットワーク操作権限を取得する必要がある.xmlに、次のコードを追加します.
<uses-permission android:name="android.permission.INTERNET" />

b、呼び出しポートAPI
例えば、佳博ネットワークプリンタの初期IPは192.168である.123.100印刷ポートは9100
mDevice.openEthernetPort(“192.168.123.100”, 9100)

4、ブルートゥース、USB、ネットポートを閉じる
クローズポートAPIの呼び出し
mDevice.closePort();

5、データの送信
即時送信データAPI
mDevice.sendDataImmediately(Vector<Byte> data)

送信データを送信バッファに配置
mDevice.sendData(Vector<Byte> data)

三、TSCとESCコマンド編集
佳博プリンタは2種類の業界命令標準を互換し、5890 XIII、58130 IVCなどの手形プリンタはESC/POS指令セットを互換する.
2120 T、2120 TLなどのシリーズラベルプリンタはTSC指令セットと互換性がある.
2120 TFはESCとTSCを同時に対応しており、モード切替にはダイヤルスイッチが必要です
1、TSCコマンド呼び出しテンプレートは以下の通りで、Gprinter SDKのJavaDocファイルにTSCCommand APIの呼び出し説明がある
TscCommand tsc = new TscCommand(60,30,0);//        、  、  

tsc.addReference(0, 0); //      

tsc.addSpeed(SPEED.SPEED1DIV5);//      

tsc.addDensity(DENSITY.DNESITY0);//      

tsc.addDirection(DIRECTION.BACKWARD);//      

tsc.addCls();//       

tsc.addSound(2, 100); tsc.addText(20,20,FONTTYPE.FONT_TAIWAN,ROTATION.ROTATON_0,FONTMUL.MUL_1,FONTMUL.MUL_1,"Hello Gprinter");//    

tsc.add1DBarcode(20, 50, BARCODETYPE.CODE128, 100, READABEL.EANBEL, ROTATION.ROTATION_180, "12345");//      

tsc.addPrint(1,1);//        

Vector<Byte> Command = new Vector<Byte>(4096, 1024); Command = tsc.getCommand();//           

mDevice.sendDataImmediately(Command);  //     

2、ESCコマンド呼び出しテンプレートは以下の通りで、Gprinter SDKのJavaDocファイルにはESCCommand APIの呼び出し説明がある
EscCommand esc = new EscCommand();
esc.addTurnEmphasizedModeOnOrOff(EscCommand.ENABLE.ON);// esc.addText("Hello World
");// esc.addUPCA("123456789012");// UPCA esc.addCODE128("Gprinter");// CODE128 Vector<Byte> Command = new Vector<Byte>(4096, 1024); Command = esc.getCommand();// mDevice.sendDataImmediately(Command);//

Eclipseの下でAndroidプロジェクトを確立した後、Gprinterを呼び出す.JArファイルは、上記の手順に従って操作するだけで、目的のラベルを自由に編集できます.