Biz/Browser HTと外部サービスを連携する機能「ExternalService」クラスを用いて使用することができるメソッドの一覧です。
通常、ExternalServiceクラスを用いてこれらの機能を呼び出す場合、下記のように利用します。
本機能一覧は、パナソニック FZ-N1端末制御モジュールv1.0.3に対応しています。
※掲載されている会社名や製品名は、一般に各社の商標または登録商標です。
使用例
/* 本端末制御モジュール専用サービスID（本サービスにおいて固定値） */
String SERVICE_ID = "jp.co.opst.biz.util.poweruptool.panasonicpoweruptool/.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メソッド | 連続スキャンを終了します。 |
| ReadBarcodeイベント | 連続スキャンでバーコードを読み取ったときに発生します。 |
| ログ出力機能 | 端末制御モジュール内での状態変化が発生した際のログをファイルに出力するための機能です。 |
|
説明 |
バーコードの読み取り処理を行い、読み込んだバーコードのデータおよび種別を返します。 バーコードの読み取りに成功するかタイムアウト時間が経過するまでスキャンを行います。 スキャンが終了し、このメソッドが結果を返すまで処理は戻りません。
|
|||||||||||||||||||||||||||||||||||||||||||
|
呼出形式 |
extsv.invoke("startScanBarcode", timeoutMs);
|
|||||||||||||||||||||||||||||||||||||||||||
|
戻り値 |
以下の3つの要素を持つ連想配列のArrayオブジェクト
integer type バーコードの種類 String data バーコードのデータの文字列表現 String rawdata バーコードのデータの生データ（バイト列）をBase64エンコードした文字列(※) ※Biz/BrowserのBase64Decoderクラスを用いてBase64デコードすることでバイナリデータを復元することができます。 読み込むバーコードに日本語の文字を含む場合や、バイナリデータを含む場合に使用できます。
バーコードの種類はそれぞれ下記に対応しています。
|
|||||||||||||||||||||||||||||||||||||||||||
|
引数 |
integer timeoutMs |
スキャンのタイムアウト時間[msec]。0以下の値を設定するとデフォルトの時間だけ待機します。
|
||||||||||||||||||||||||||||||||||||||||||
|
使用例 |
var res = extsv.Invoke("startScanBarcode", 3000);
//.MessageBox("データ:" + res[0]["data"] + "/種類:" + Str(res[0]["type"]) + "/生データ:" + Base64Decoder.Convert(res[0]["rawdata"]));
|
|||||||||||||||||||||||||||||||||||||||||||
|
説明 |
連続スキャンを開始します。 バーコードを読み取ると、ExternalServiceオブジェクトからReadBarcodeイベントが発生します。 読み取ったバーコードのデータはReadBarcodeイベントから取得することができます。 連続スキャンを停止する場合は、stopScanBarcodeメソッドを呼び出します。
|
|
|
呼出形式 |
var res = extsv.invoke("startScanBarcodeContinuous", sameInterval);
|
|
|
戻り値 |
なし
|
|
|
引数 |
integer sameInterval |
同一バーコードの二度読み防止時間を、100ミリ秒単位で指定します。
|
|
使用例 |
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);
}
}
|
|
|
説明 |
連続スキャンを終了します。
|
|
|
呼出形式 |
extsv.invoke("stopScanBarcode");
|
|
|
戻り値 |
なし
|
|
|
引数 |
なし |
|
|
説明 |
連続スキャンでバーコードを読み取ったときに発生します。
Eventオブジェクトには以下の子オブジェクトが付加されています。
|
|||||||||||||
|
説明 |
端末制御モジュール内での状態変化が発生した際のログをファイルに出力するための機能です。
■ログファイル作成タイミング 端末制御モジュールBind時にログファイルが作成され、以降端末制御モジュール内での状態が変化したタイミングでログが追記されていきます。端末制御モジュールUnBind時にファイルがクローズされます。
■設定ファイル
■設定値
■ログファイル
設定ファイル例 DeviceControlExtensionLog:true LogFileCountMax:5
|
||||||||||||||||||||