|
説明 |
バーコードおよび二次元コードをスキャンします。
本メソッドを呼び出すことで、バーコードおよび二次元コードの読取画面が表示されます。 使用の際は下記の点にご注意下さい。 (以下、バーコードシンボルおよび二次元コードシンボルのことをシンボルと呼称します)
読取設定について ・誤検知の防止やパフォーマンスの向上のため、コード種別の絞り込みや読取データ長の指定、読取対象外エリアを設定することをおすすめします。
読取時の操作 ・読取の際は読取画面内の読取エリアに読み取りたいシンボルがしっかりと映り込むように端末を動かして下さい。 ・特に二次元コード(QRコード、DataMatrix等)を読み取る場合、できるだけシンボルを真上から撮影して下さい。
読み取り精度やパフォーマンスについて ・シンボルの認識精度や認識速度に関してはお使いの端末や使用環境、シンボルの状態などに依存します。 ・シンボルが常に正しく読み取れることは保証しておりません。必要に応じて読取データ長の確認やチェックディジットの検証、マスタとの突合などの処理を追加して下さい。 ・同時に認識できるシンボル数はコード種別や読取状況に依存します。 特に二次元コード(QRコード、DataMatrix等)の場合、同時に複数のシンボルを認識出来ない可能性があります。
Android版
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
呼出形式 |
var result = Runtime.ShowCodeScanner( sourceType [, format [, extraParams ]] );
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
戻り値 |
下記の構造を持つRecord配列を返します。読取がキャンセルされた場合、長さ0のRecord配列を返します。
Record {
Number Format; /* 読み取ったコードの種別。引数formatに指定した種別のうちいずれかが格納されます。 */
String Data; /* コードの読取結果が文字列で格納されます。 */
Number IsComposite; /* 読み取ったコードが合成シンボルの場合は1、そうでない場合は0が格納されます。 */
Number IsGS1; /* 読み取ったコードがGS1の場合は1、そうでない場合0が格納されます。 */
Array GS1DataList; /* GS1コードに含まれるデータの配列が格納されます。 */
}
GS1DataListは下記の構造を持つRecord配列です。
Record {
String Key; /* アプリケーション識別子(AI) */
String Label; /* アプリケーション識別子に対応した名前 */
String Value; /* データが文字列形式で格納されます。日付データの場合はYYYY/MM/DD hh:mm:ssの形式で格納されます。 */
}
合成シンボルかどうか、およびGS1かどうかは、extraParamsの"DETECT_ENGINE"に"ATAMI"、もしくは"AsCameraX"を指定した場合に判定されます。 また、GS1DataListは"DETECT_ENGINE"に"ATAMI"を指定した場合に格納されます。 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
引数 |
integer sourceType |
画像を取得する対象を指定します。 指定できる値は下記のとおりです。
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
integer format |
読取対象のバーコード/二次元コード種別を組み合わせて指定します。 デフォルトではRuntime.CODE_FORMAT_ALLが指定されます。
extraParamsの"DETECT_ENGINE"で指定するバーコード検出エンジンによって対応バーコードが異なります。
※1 : EAN-13として認識されるシンボル内、先頭が0となっているものはUPC-Aとして扱われます。 ※2 : 他の定数と組み合わせず、単体で指定して下さい。 ※3 : 将来的に読取できるコード種別が追加された場合、そのコードも読取対象となります。 ※4 : 6文字以上(スタートストップ文字入れて8文字以上)のみ読み取り可能です。 ※5 : "DETECT_ENGINE"が"ATAMI"かデフォルトの場合、QRコード モデル1は読み取ることはできません。 ※6 : "DETECT_ENGINE"が"AsCameraX"の場合、チェックディジットが不正な値となっているUPCおよびEANは読み取れません。 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
Array extraParams |
その他細かな設定を指定します。 引数のArrayのキー(文字列)に設定名を、値に設定値を格納します。
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
例外 |
FUNC-4 |
引数の値が不正です |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
RTM-46 |
カメラの操作に失敗しました。 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
使用例 |
try{
/* リアカメラから読み取ります */
var sourceType = Runtime.SourceTypeRearCamera;
/* EAN13バーコードおよびQRコードのみを読み取ります */
var format = Runtime.CODE_FORMAT_EAN13 + Runtime.CODE_FORMAT_QR_CODE;
/* UPC-AバーコードをEAN13バーコードに読み替えます */
var extraParams = new Array;
extraParams["CONVERT_UPCA_TO_EAN13"] = true;
/* 読取開始 */
var rtm = new Runtime;
var result = rtm.ShowCodeScanner(sourceType, format, extraParams);
/* 結果表示 */
if(result.length > 0) {
//.MessageBox("読取結果 : " + result[0].data, "種別 : " + str(result[0].format));
} else {
//.MessageBox("読取はキャンセルされました");
}
}catch(e){
//.MessageBox(e.Method + "-" + str(e.Code));
//.MessageBox(e.message);
}
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
関連項目 |
LoadSoundメソッド |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||