Biz/Browser HTと外部サービスを連携する機能「ExternalService」クラスを用いて使用することができるメソッドの一覧です。
本項では、RFIDリーダ制御モジュールで使用可能な機能を説明します。
サービスの使い方については、Biz/Browser HTのExternalServiceクラスのリファレンスも参照してください。
対応機種とモジュール
メーカ |
対応機種 |
値 |
略称と対応モジュール |
|---|---|---|---|
|
東北システムズ・サポート |
DOTR-3200 |
jp.co.opst.biz.util.rfid.tss/.MainService |
TSS、TSS版 |
※掲載されている会社名や製品名は、一般に各社の商標または登録商標です。
本APIリファレンスのバージョン
モジュール |
バージョン |
Biz/Browserの対応バージョン |
|---|---|---|
|
TSS版 |
v1.0.1まで |
v1.2.6 |
|
v1.1.0 |
v1.4.4 |
| メソッド名 | 概要 |
|---|---|
| connect | RFIDリーダと接続します。ペアリング済みのリーダを自動的に検出して接続します。 |
| disconnect | RFIDリーダとの接続を切断します。 |
| inventoryTag | インベントリ（スキャンを開始してRFタグのEPCを収集）を行います。 |
| stopAccessTag | スキャンを停止します。 |
| startReadTag | タグの読み取りを行います。インベントリと異なり、タグの任意の領域にアクセスしてデータを受け取ります。 |
| setTagAccessOnce | 同一のタグ（UII）を一度だけ読むようにするどうかを設定します。 |
| isTagAccessOnce | 同一のタグ（UII）を一度だけ読むようにするかどうかの設定を取得します。 |
| clearAccessTagList | スキャンしたタグの内部のリストをクリアします。同一タグの読み取りの判定に用います。 |
| setMask | タグの読み取りマスクを設定します。 |
| clearMask | タグの読み取りマスクを消去します。 |
| setTagDecode | 読み取ったタグをReadTagイベントで通知する際に、タグのデータをデコードするかどうかを設定します。 |
| setRadioChannel | 出力電波のチャンネルを設定します。 |
| getRadioChannel | 出力電波のチャンネルを取得します。 |
| setRadioPower | 出力電波の強度を設定します。高いほどタグが応答しやすくなり、読み取りが成功しやすくなります。 |
| getRadioPower | 出力電波の強度を取得します。 |
| setQValue | Q値を設定します。高いほどタグの読み取り衝突を抑えやすくなります。 |
| getQValue | Q値を取得します。 |
| setBuzzerVolume | 読み取り時などのブザー音の音量を設定します。 |
| getBuzzerVolume | 読み取り時などのブザー音の音量を取得します。 |
| setSessionFlag | タグへのアクセス時のセッションフラグを設定します。 |
| getSessionFlag | タグへのアクセス時のセッションフラグを取得します。 |
| writeSingleTag | UIIを指定して1枚のタグの任意の領域に書き込みを行います。 |
| lockSingleTag | UIIを指定して1枚のタグの任意の領域をロックまたはアンロックします。 |
| getVersion | 本モジュールのバージョンを取得します。 |
| getBatteryLevel | バッテリー残量を取得します。 |
| intrinsic.connect | RFIDリーダと接続します。 |
| startScanBarcode | バーコードスキャンを開始します。 |
| stopScanBarcode | バーコード読み取りを停止します。 |
| setTxTime | 電波照射時間を指定します。 |
| getTxTime | 電波照射時間を取得します。 |
| setDecodeTagEPC | タグEPC読み取り時に、EPCを標準コードなどにデコードするかどうか、その方法を指定します。 |
| ReadTagイベント | inventoryTagメソッドやstartReadTagメソッドでタグを読み取ったときに発生します。 |
| DeviceStateChangedイベント | connectやdisconnectやRFIDリーダの操作により、RFIDリーダの状態が変化したときに発生します。 |
| TriggerChangedイベント | RFIDリーダのトリガーの押下状態が変化したときに発生します。 |
| ReadBarcodeイベント | startScanBarcodeメソッドでバーコードを読み込んだときに発生します。 |
説明 |
RFIDリーダと接続します。ペアリング済みのリーダを自動的に検出して接続します。 ※RFIDリーダのペアリング等のハードウェア側の操作については、メーカードキュメントをご参照ください。
詳細な接続方法が指定できるintrinsic.connectメソッドも参照してください。
|
|
呼出形式 |
externalService1.invoke("connect", deviceName);
|
|
戻り値 |
なし
|
|
引数 |
String deviceName
|
ペアリング済みRFIDリーダデバイスの名称、もしくはBluetoothアドレス（MACアドレス）
|
説明 |
RFIDリーダとの接続を切断します。
|
|
呼出形式 |
externalService1.invoke("disconnect");
|
|
戻り値 |
なし
|
|
引数 |
なし
|
|
説明 |
インベントリ（スキャンを開始してRFタグのEPCを収集）を行います。
|
|
呼出形式 |
externalService1.invoke("inventoryTag");
|
|
戻り値 |
なし
|
|
引数 |
なし
|
|
説明 |
スキャンを停止します。
|
|
呼出形式 |
externalService1.invoke("stopAccessTag");
|
|
戻り値 |
なし
|
|
引数 |
なし
|
|
説明 |
タグの読み取りを行います。インベントリと異なり、タグの任意の領域にアクセスしてデータを受け取ります。
|
||||||||||
呼出形式 |
externalService1.invoke("startReadTag", memoryType, wordOffset, wordCount [, password]);
|
||||||||||
戻り値 |
なし
|
||||||||||
引数 |
|||||||||||
|
integer memoryType
|
読み取るメモリ領域
|
||||||||||
|
integer wordOffset
|
アクセス対象のオフセット位置（ワード単位） ※1ワードは2バイト
|
||||||||||
|
integer wordCount
|
オフセット位置から読み取るデータの長さ（ワード単位）
|
||||||||||
|
String password
|
タグに設定されているアクセスパスワードを16進数文字列で指定します。省略時は0です。
|
||||||||||
説明 |
同一のタグ（UII）を一度だけ読むようにするどうかを設定します。
|
|
呼出形式 |
externalService1.invoke("setTagAccessOnce", once);
|
|
戻り値 |
なし
|
|
引数 |
boolean once
|
一度だけ読むようにするかどうかを設定します。
|
説明 |
同一のタグ（UII）を一度だけ読むようにするかどうかの設定を取得します。
|
|
呼出形式 |
var res = externalService1.invoke("isTagAccessOnce");
|
|
戻り値 |
一度だけ読むようにするかどうかの設定を返します。
|
|
引数 |
なし
|
|
説明 |
スキャンしたタグの内部のリストをクリアします。同一タグの読み取りの判定に用います。
|
|
呼出形式 |
externalService1.invoke("clearAccessTagList");
|
|
戻り値 |
なし
|
|
引数 |
なし
|
|
説明 |
タグの読み取りマスクを設定します。 ※SR7の場合は、USER領域の存在しないタグのUSER領域に対してマスクを指定すると読み取れないことがあります。
|
||||||||
呼出形式 |
externalService1.invoke("setMask", memoryType, maskOffset, maskBits, maskPattern);
|
||||||||
戻り値 |
なし
|
||||||||
引数 |
|||||||||
|
integer memoryType
|
マスクの対象とするメモリ領域
|
||||||||
|
integer maskOffset
|
メモリ領域内の、マスク対象とするオフセット位置（ビット単位）
|
||||||||
|
integer maskBits
|
マスク対象とするデータの長さ（ビット単位）
|
||||||||
|
String maskPattern
|
マスクパターン。16進数文字列で指定。
|
||||||||
説明 |
タグの読み取りマスクを消去します。
|
|
呼出形式 |
externalService1.invoke("clearMask");
|
|
戻り値 |
なし
|
|
引数 |
なし
|
|
説明 |
読み取ったタグをReadTagイベントで通知する際に、タグのデータをデコードするかどうかを設定します。
|
|
呼出形式 |
externalService1.invoke("setTagDecode", enabled);
|
|
戻り値 |
なし
|
|
引数 |
boolean enabled
|
デコードするかどうか。trueならする、falseならしない。デフォルトはfalseです。
|
説明 |
出力電波のチャンネルを設定します。 ※本機能はSR7では使用できません。
|
|||||||||||||||
呼出形式 |
externalService1.invoke("setRadioChannel", channels);
|
|||||||||||||||
戻り値 |
なし
|
|||||||||||||||
引数 |
integer channels
|
以下の値の組み合わせで、使用するチャンネルを指定します。
|
||||||||||||||
説明 |
出力電波のチャンネルを取得します。 ※本機能はSR7では使用できません。
|
|||||||||||||||
呼出形式 |
var res = externalService1.invoke("getRadioChannel");
|
|||||||||||||||
戻り値 |
出力電波の設定が値の組み合わせで返ります。
|
|||||||||||||||
引数 |
なし
|
|||||||||||||||
説明 |
出力電波の強度を設定します。高いほどタグが応答しやすくなり、読み取りが成功しやすくなります。
|
|
呼出形式 |
externalService1.invoke("setRadioPower", power);
|
|
戻り値 |
なし
|
|
引数 |
integer power
|
出力電波強度 [dBm]を、1～30の値で指定します。
|
説明 |
出力電波の強度を取得します。
|
|
呼出形式 |
var res = externalService1.invoke("getRadioPower");
|
|
戻り値 |
出力電波強度 [dBm]
|
|
引数 |
なし
|
|
説明 |
Q値を設定します。高いほどタグの読み取り衝突を抑えやすくなります。 ※本機能はSR7では使用できません。
|
|||||
呼出形式 |
externalService1.invoke("setQValue", val);
|
|||||
戻り値 |
なし
|
|||||
引数 |
integer val
|
Q値 (2のn乗[枚])
|
||||
説明 |
Q値を取得します。 ※本機能はSR7では使用できません。
|
|
呼出形式 |
var res = externalService1.invoke("getQValue");
|
|
戻り値 |
Q値 (2のn乗[枚])
|
|
引数 |
なし
|
|
説明 |
読み取り時などのブザー音の音量を設定します。 ※本機能はSR7では音量を設定することはできません。ミュートのときはブザー音は無効、それ以外のときは有効となります。
|
||||||||
呼出形式 |
externalService1.invoke("setBuzzerVolume", val [, persitent]);
|
||||||||
戻り値 |
なし
|
||||||||
引数 |
|||||||||
|
integer val
|
ブザー音量 [%] 通常、0～100の範囲で設定します。
|
||||||||
|
boolean persitent
|
設定を端末で保持し、次回接続時に自動的に反映するかどうか。trueなら自動設定します。デフォルトはfalseです。
|
||||||||
説明 |
読み取り時などのブザー音の音量を取得します。 ※本機能はSR7では使用できません。
|
|
呼出形式 |
var res = externalService1.invoke("getBuzzerVolume");
|
|
戻り値 |
ブザー音量 [%]
|
|
引数 |
なし
|
|
説明 |
タグへのアクセス時のセッションフラグを設定します。
|
|||||||||||
呼出形式 |
externalService1.invoke("setSessionFlag", session);
|
|||||||||||
戻り値 |
なし
|
|||||||||||
引数 |
integer session
|
セッションフラグを、以下の値のいずれかで指定します。
|
||||||||||
説明 |
タグへのアクセス時のセッションフラグを取得します。
|
|||||||||||
呼出形式 |
var res = externalService1.invoke("getSessionFlag");
|
|||||||||||
戻り値 |
セッションフラグを返します。
|
|||||||||||
引数 |
なし
|
|||||||||||
説明 |
UIIを指定して1枚のタグの任意の領域に書き込みを行います。 ※実行後にフィルター設定が自動的に変更されるため、適宜setMaskメソッドやclearMaskメソッドを呼び出してください。
|
||||||||||
呼出形式 |
externalService1.invoke("writeSingleTag", memoryType, wordOffset, words, uii [, password]);
|
||||||||||
戻り値 |
なし
|
||||||||||
引数 |
|||||||||||
|
integer memoryType
|
書き込み先のメモリ領域
|
||||||||||
|
integer wordOffset
|
アクセス対象のオフセット位置（ワード単位）
|
||||||||||
|
integer words
|
タグに書き込むデータ（ワード単位の長さ）
|
||||||||||
|
String uii
|
書き込むタグのUII
|
||||||||||
|
String password
|
タグに設定されているアクセスパスワードを16進数文字列で指定します。省略時は0です。
|
||||||||||
説明 |
UIIを指定して1枚のタグの任意の領域をロックまたはアンロックします。
|
||||||||||||
呼出形式 |
externalService1.invoke("lockSingleTag", target, type, uii [, password]);
|
||||||||||||
戻り値 |
なし
|
||||||||||||
引数 |
|||||||||||||
|
integer target
|
操作対象。値の組み合わせで複数指定できます。
|
||||||||||||
|
integer type
|
操作内容
|
||||||||||||
|
String uii
|
操作するタグのUII
|
||||||||||||
|
String password
|
タグに設定されているアクセスパスワードを16進数文字列で指定します。省略時は0です。
|
||||||||||||
説明 |
本モジュールのバージョンを取得します。
|
|
呼出形式 |
var res = externalService1.invoke("getVersion");
|
|
戻り値 |
バージョン番号が文字列で返ります。
|
|
引数 |
なし
|
|
説明 |
バッテリー残量を取得します。
|
|
呼出形式 |
var res = externalService1.invoke("getBatteryLevel");
|
|
戻り値 |
バッテリー残量 [%]
|
|
引数 |
なし
|
|
説明 |
RFIDリーダと接続します。 ※本メソッドは非推奨APIで、互換性のために残されています。通常はconnectメソッドをご利用ください。
|
|
|
説明 |
バーコードスキャンを開始します。 読み取ったバーコードはReadBarcodeイベントとしてBiz/Browserに送信されます。
|
|
呼出形式 |
externalService1.invoke("startScanBarcode",sameInterval,oneshot);
|
|
戻り値 |
なし
|
|
|
引数 |
integer sameInterval
boolean oneshot |
同じバーコードを読み取らない時間。0なら無制限に読み取らない。デフォルト0。
一度バーコードを読み取ったら強制的にスキャンを終了するかどうか。デフォルトfalse。
|
説明 |
バーコード読み取りを停止します。
|
|
呼出形式 |
externalService1.invoke("stopScanBarcode");
|
|
戻り値 |
なし
|
|
引数 |
なし
|
|
説明 |
電波照射時間を指定します
|
|
呼出形式 |
externalService1.invoke("setTxTime", TxTime);
|
|
戻り値 |
なし
|
|
引数 |
Integer TxTime
|
電波の照射時間を指定します(ミリ秒)。指定できる範囲は機種により異なります。確認してください。
|
説明 |
電波照射時間を取得します。
|
|
呼出形式 |
var res = externalService1.invoke("getTxTime");
|
|
戻り値 |
指定されている電波照射時間(ミリ秒)
|
|
引数 |
なし
|
|
説明 |
タグEPC読み取り時に、EPCを標準コードなどにデコードするかどうか、その方法を指定します。
|
|||||||
呼出形式 |
externalService1.invoke("setDecodeTagEPC", type);
|
|||||||
戻り値 |
なし
|
|||||||
引数 |
integer type
|
変換方法を指定します。
|
||||||
説明 |
inventoryTagメソッドやstartReadTagメソッドでタグを読み取ったときに発生します。
Eventオブジェクトには以下の子オブジェクトが付加されています。
|
|||||||||||||||||||
説明 |
connectメソッドやdisconnectメソッドやRFIDリーダの操作により、RFIDリーダの状態が変化したときに発生します。
Eventオブジェクトには以下の子オブジェクトが付加されています。
|
|||||||
説明 |
RFIDリーダのトリガーの押下状態が変化したときに発生します。
Eventオブジェクトには以下の子オブジェクトが付加されています。
|
|||||||
説明 |
startScanBarcodeメソッドでバーコードを読み込んだときに発生します。
Eventオブジェクトには以下の子オブジェクトが付加されています。
バーコードのタイプの種類は以下の通りです。
|
|||||||||||||||||||||||||||||||||||||||||||||||||||