KEYENCE BT-A700端末制御モジュールの機能一覧

 

 

Biz/Browser HTと外部サービスを連携する機能「ExternalService」クラスを用いて使用することができるメソッドの一覧です。
サービスの使い方については、Biz/Browser HTのExternalServiceクラスのリファレンスも参照してください。

※正しく動作させるためには、端末のOSバージョンを最新にする必要があります。

 

本モジュールとリファレンスについて

メーカ

対応機種

サービスID値

バージョン

Biz/Browserの対応バージョン

キーエンス

BT-A700

jp.co.opst.biz.util.poweruptool.keyencepoweruptool/.MainService

v1.0.4

v1.2.0以上

※掲載されている会社名や製品名は、一般に各社の商標または登録商標です。

 

使用例

/* 本端末制御モジュール専用サービスID（本サービスにおいて固定値） */
String SERVICE_ID = "jp.co.opst.biz.util.poweruptool.keyencepoweruptool/.MainService";
/* メソッド名称 */
String METHOD_NAME = "playBuzzer";

ExternalService sv{
	Function OnBoundStateChanged(e){
		if(e.state == "Bound"){
			//.Messagebox("サービスと接続しました");
		}
	}
}
Button btn1{
	Function OnTouch(e){
		^.sv.bind(^.SERVICE_ID);
	}
}

Button btn2{
	Function OnTouch(e){
		^.sv.invoke(^.METHOD_NAME, 7, 2000);
	}
}

 

目次

 

メソッド名 概要
startScanBarcode バーコードの読み取り処理を行い、読み込んだバーコードのデータおよび種別を返します。
startScanBarcodeContinuous 連続スキャンを開始します。
stopScanBarcode 連続スキャンを終了します。
setNotificationBuzzer 端末の各種通知音の有効・無効を設定します。
getNotificationBuzzer 端末の各種通知音の有効・無効設定を取得します。
setNotificationVibrator 端末の各種通知バイブレータの有効・無効を設定します。
getNotificationVibrator 端末の各種通知バイブレータの有効・無効設定を取得します。
setBarcodeEnabled 指定したバーコードを読み取り対象にするかどうかを指定します。
isBarcodeEnabled 指定したバーコードが読み取り対象かどうかを取得します。
setStandardBarcodeEnabled 読み取り可能なすべてのバーコードについて、読み取り対象にするかどうかを設定します。
ReadBarcodeイベント 連続スキャンでバーコードを読み取ったときに発生します。

 

startScanBarcodeメソッド

説明

バーコードの読み取り処理を行い、読み込んだバーコードのデータおよび種別を返します。

バーコードの読み取りに成功するかタイムアウト時間が経過するまでスキャンを行います。

スキャンが終了し、このメソッドが結果を返すまで処理は戻りません。

 

呼出形式

var res = extsv.invoke("startScanBarcode", timeoutMs);

 

戻り値

以下の3つの要素を持つ連想配列のArrayオブジェクト

 

integer		type	バーコードの種類
String		data	バーコードのデータの文字列表現
String		rawdata	バーコードのデータの生データ（バイト列）をBase64エンコードした文字列(※)

※Biz/BrowserのBase64Decoderクラスを用いてBase64デコードすることでバイナリデータを復元することができます。
　読み込むバーコードに日本語の文字を含む場合や、バイナリデータを含む場合に使用できます。

 

バーコードの種類はそれぞれ下記に対応しています。

値バーコードの種類
1EAN-13(JAN-13)
2EAN-8(JAN-8)
4UPC-A
6郵便カスタマーバーコード
9ITF
11CODE-128
12CODE-93
13CODE-39
14CODABAR(NW-7)
17QR
18GS1 DataBar
25PDF417/2Dタイプ
26Data Matrix
29Industrial 2of5
30COOP 2of5

    ※ 以下のバーコードはバーコード種別が異なる形で検知します。

      ・ UPC-E は、 2（ EAN-8(JAN-8) ）で検知します。

      ・ GS1-128 は、 11（ CODE-128 ）で検知します。

      ・ Micro PDF は、 25（ PDF417/2Dタイプ ）で検知します。

 

引数

integer timeoutMs

スキャンのタイムアウト時間[msec]。0以下の値を設定するとデフォルトの時間だけ待機します。
デフォルトのタイムアウト時間は7秒です。

 

使用例

 
var res = extsv.Invoke("startScanBarcode", 3000);
//.MessageBox("データ:" + res[0]["data"] + "/種類:" + Str(res[0]["type"]) + "/生データ:" + Base64Decoder.Convert(res[0]["rawdata"]));

 

startScanBarcodeContinuousメソッド

説明

連続スキャンを開始します。

バーコードを読み取ると、ExternalServiceオブジェクトからReadBarcodeイベントが発生します。

読み取ったバーコードのデータはReadBarcodeイベントから取得することができます。

連続スキャンを停止する場合は、stopScanBarcodeメソッドを呼び出します。

 

呼出形式

extsv.invoke("startScanBarcodeContinuous", sameInterval);

 

戻り値

なし

 

引数

integer sameInterval

同一バーコードの二度読み防止時間を、100ミリ秒単位で指定します。
1以上を設定すると、同一のバーコードを設定した時間が経過するまで読み取りません。
0を設定すると、同一バーコードは異なるバーコードを読み取るまで読み取りません。

 

使用例

 
ExternalService exs{
	Function OnReadBarcode(e){
		^.Label1.value = e.type + " : " + e.data ;
	}
}
Button Button51 {
    X = 199;
    Y = 333;
    Width = 80;
    Height = 54;
    Title = "スキャン開始";

    Function OnTouch( e ) {
        var res = ^.exs.Invoke("startScanBarcodeContinuous", 3);
    }
}

 

stopScanBarcodeメソッド

説明

連続スキャンを終了します。

 

呼出形式

extsv.invoke("stopScanBarcode");

 

戻り値

なし

 

引数

なし

 

setNotificationBuzzerメソッド

説明

端末の各種通知音の有効・無効を設定します。

 

呼出形式

extsv.invoke("setNotificationBuzzer", type, enabled);

 

戻り値

なし

 

引数

integer type

通知音の種類。現在は1(スキャン成功時)のみ指定できます。

 

 

boolean enabled

通知音を有効にするかどうか。

 

 

getNotificationBuzzerメソッド

説明

端末の各種通知音の有効・無効設定を取得します。

 

呼出形式

var res = extsv.invoke("getNotificationBuzzer", type);

 

戻り値

typeに指定した種類の通知音が有効ならtrue、そうでなければfalseを返します。

 

引数

integer type

通知音の種類。現在は1(スキャン成功時)のみ指定できます。

 

 

setNotificationVibratorメソッド

説明

端末の各種通知バイブレータの有効・無効を設定します。

 

呼出形式

extsv.invoke("setNotificationVibrator", type, enabled);

 

戻り値

なし

 

引数

integer type

通知バイブレータの種類。現在は1(スキャン成功時)のみ指定できます。

 

 

boolean enabled

通知バイブレータを有効にするかどうか。

 

 

getNotificationVibratorメソッド

説明

端末の各種通知バイブレータの有効・無効設定を取得します。

 

呼出形式

var res = extsv.invoke("getNotificationVibrator", type);

 

戻り値

typeに指定した種類の通知バイブレータが有効ならtrue、そうでなければfalseを返します。

 

引数

integer type

通知バイブレータの種類。現在は1(スキャン成功時)のみ指定できます。

 

 

setBarcodeEnabledメソッド

説明

指定したバーコードを読み取り対象にするかどうかを指定します。

 

呼出形式

var res = extsv.invoke("setBarcodeEnabled", type, enabled);

 

戻り値

成功した場合はtrueを、失敗した場合はfalseを返します。

 

引数

integer type

設定を行うバーコードの種類を指定します。

バーコードの種類はそれぞれ下記に対応しています。

値バーコードの種類
1EAN-13(JAN-13)
2EAN-8(JAN-8)
4UPC-A
6郵便カスタマーバーコード
9ITF
11CODE-128
12CODE-93
13CODE-39
14CODABAR(NW-7)
17QR
18GS1 DataBar
25PDF417/2Dタイプ
26Data Matrix
29Industrial 2of5
30COOP 2of5

 

※EAN-13、EAN-8、UPC-Aの設定は共通となります。

 

 

boolean enabled

読み取りを行う場合は$TRUEを、読み取りを行わない場合は$FALSEを指定します。

 

isBarcodeEnabledメソッド

説明

指定したバーコードが読み取り対象かどうかを取得します。

 

呼出形式

var res = extsv.invoke("isBarcodeEnabled", type);

 

戻り値

読み取り対象である場合はtrueを、読み取り対象ではない場合はfalseを返します。

 

引数

integer type

設定を取得するバーコードの種類を指定します。

バーコードの種類はそれぞれ下記に対応しています。

値バーコードの種類
1EAN-13(JAN-13)
2EAN-8(JAN-8)
4UPC-A
6郵便カスタマーバーコード
9ITF
11CODE-128
12CODE-93
13CODE-39
14CODABAR(NW-7)
17QR
18GS1 DataBar
25PDF417/2Dタイプ
26Data Matrix
29Industrial 2of5
30COOP 2of5

 

※EAN-13、EAN-8、UPC-Aの設定は共通となります。

 

setStandardBarcodeEnabledメソッド

説明

読み取り可能なすべてのバーコードについて、読み取り対象にするかどうかを設定します。

 

読み取り可能に設定した場合、端末の制限および誤検出防止のため、下記は読み取り対象外に設定されます。

バーコード理由
Composite AB(GS1-Databar)Gs1 Databarと排他で指定する必要があるため
Composite AB(EAN/UPC)UPC/EAN/JANと排他で指定する必要があるため
Composite(GS1-128)CODE-128と排他で指定する必要があるため
Postal(郵便カスタマーバーコード)他のバーコードと同時に指定すると、レーザー照射部が点灯しなくなるなど動作異常を起こすことがあるため
OCR(文字認識)読み取りエラーが発生しやすくなるため

 

呼出形式

var res = extsv.invoke("setStandardBarcodeEnabled", enabled);

 

戻り値

成功した場合はtrueを、失敗した場合はfalseを返します。

 

引数

boolean enabled

読み取りを行う場合はtrueを、読み取りを行わない場合はfalseを指定します。

 

 

ReadBarcodeイベント

説明

startScanBarcodeContinuousメソッドによる連続スキャンでバーコードを読み取ったときに発生します。

 

Eventオブジェクトには以下の子オブジェクトが付加されています。

型

名前

説明

String

type

バーコード種別

String

data

バーコードのデータの文字列表現

String

rawdata

バーコードのデータの生データ（バイト列）をBase64エンコードした文字列(※)

※Biz/BrowserのBase64Decoderクラスを用いてBase64デコードすることでバイナリデータを復元することができます。
　読み込むバーコードに日本語の文字を含む場合や、バイナリデータを含む場合に使用できます。