Gprinter Android SDK V1.0使用説明
8199 ワード
Gprinter Android SDKは、佳博ユーザーがより迅速で、より効率的にAndroidプラットフォームの下で佳博プリンタを開発し、使用することを目的としています.SDKで問題が発生したり、バグが見つかったりした場合は、メッセージを残してください
一、GprinterSDKをダウンロードする
GprinterSDKは、佳博プリンタの公式サイトでGprinterSDKをダウンロードしたり、カスタマーサービス担当者に連絡したりしてダウンロードすることができます.
一、gprinter.JArプロジェクトへのインポート
eclipseでgprinter.JArはプロジェクトのlibsフォルダの下にコピーします.
二、プリンタとの通信を確立する
1、デバイスのオブジェクトを取得する
2.受信データコールバック関数を登録する(このインタフェースはデータを受信するためのものである)
3、ブルートゥース、USB、ネットポートを開く
Bluetooth通信:
a、AndroidManifestでBluetoothの操作権限を取得する必要がある.xmlに、次のコードを追加します.
b、ブルートゥースを呼び出してAPIを開く
contextはコンテキストで、addrはBluetoothアドレスです.例えば、Bluetoothアドレスが「98:D 3:31:40:27:D 7」の場合、
USB通信
a、AndroidManifestでUSB操作権限を取得する必要がある.xmlに、次のコードを追加します.
b、USBデバイスを登録してブロードキャストを挿入し、抜いて、AndroidManifestにある.xmlに、次のコードを追加します.
c、device_filter.xmlはUSBデバイスのためにファイルを濾過して、中はUSBデバイスのPIDとVID番号を記憶して、一致するデバイスのUSBが挿入するだけあって、やっとUSBが挿入してあるいは放送を抜くことを生むことができて、device_filter.xmlはres/xmlフォルダの下に置く必要があります.ファイル形式は以下の通りです.例えば、Gp 2120 TLラベルプリンタVIDは26728 PIDは1280です.
d、旧版のAndroid SDKではUSBhostはサポートされておらず、最小SDKバージョンは12なので加入が必要です
e、USBポートを呼び出してAPIを開く
ネットワークポートつうしん
a、AndroidManifestでネットワーク操作権限を取得する必要がある.xmlに、次のコードを追加します.
b、呼び出しポートAPI
例えば、佳博ネットワークプリンタの初期IPは192.168である.123.100印刷ポートは9100
4、ブルートゥース、USB、ネットポートを閉じる
クローズポートAPIの呼び出し
5、データの送信
即時送信データAPI
送信データを送信バッファに配置
三、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の呼び出し説明がある
2、ESCコマンド呼び出しテンプレートは以下の通りで、Gprinter SDKのJavaDocファイルにはESCCommand APIの呼び出し説明がある
Eclipseの下でAndroidプロジェクトを確立した後、Gprinterを呼び出す.JArファイルは、上記の手順に従って操作するだけで、目的のラベルを自由に編集できます.
一、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ファイルは、上記の手順に従って操作するだけで、目的のラベルを自由に編集できます.