霍尼韦尔安卓系统OdooApp数据扫码消息广播API

Honeywell Android Data Odoo App Collection Intent API

欧度软件数据收集Intent API 可在 Honeywell Android 手机终端与平板电脑使用。它通过提供简单易用的系统消息 API 即可对扫码硬件模块的访问，而无需安装复杂的 Honeywell SDK 来深度集成。

OdooApp先发送一个Intent事件来启动扫描程序并配置扫码参数，再发送另一个Intent事件来结束扫描程序。还有可选的第三个Intent事件用来指定内外部扫码设备。

OdooApp也需要实现一个Intent事件监听器，以从扫描头接收条形码或二维码的解析结果事件处理程序。

Odoo安卓应用程序代码实施清单：

Android Manifest 

<uses-permission android:name="com.honeywell.decode.permission.DECODE" />

Activity.onResume()

为激光扫码结果创建 Intent 接收器。发送 intent 以启动红外扫描程序。

Activity.onPause() 

发送 intent 以主动结束扫描程序。

ACTION_CLAIM_SCANNER事件：

全称： com.honeywell.aidc.action.ACTION_CLAIM_SCANNER

OdooApp发送此 intent 以设置扫描仪并开始以独占方式接收条形码数据。正常行为会认领内部扫描程序。如果连接了外部扫描程序，则默认行为将连接到外部扫描程序。

使用扫码硬件模块 com.honeywell.aidc.extra.EXTRA_SCANNER
dcs.scanner.imager：使用内置扫码模块。
dcs.scanner.ring：使用外部连接扫描枪。

使用扫码配置文件 com.honeywell.aidc.extra.EXTRA_PROFILE

扫描配置文件包含扫码模组的一系列详细属性参数设置。要在设备上创建配置文件，请转到 Android 系统 设置 > 扫描。创建配置文件时，请输入OdooApp名称。您的应用程序将按此名称选择配置文件。

创建 ACTION_CLAIM_SCANNER Intent 时，将 EXTRA_PROFILE extra string 值设置为OdooApp。

使用 EZConfig 进行配置，扫描配置文件处于DataCollectionService.xml。

如要在 Scanning 设置中使用 Default 配置文件，请将其设置为 “DEFAULT”。如果未提供配置文件名称，扫描头将使用出厂默认设置。

使用扫码属性参数 com.honeywell.aidc.extra.EXTRA_PROPERTIES

创建 ACTION_CLAIM_SCANNER Intent 时，设置 EXTRA_PROPERTIES Intent extra Bundle。Bundle 包含应用程序所需的所有扫描属性。属性名称和值记录在 com.honeywell.aidc.BarcodeReader 类中。

如果 EXTRA_PROFILE 和 EXTRA_PROPERTIES 都同时用于定义扫码属性，则 EXTRA_PROPERTIES 优先并覆盖所选配置文件的对应属性参数。

ACTION_RELEASE_SCANNER 事件：

全称： com.honeywell.aidc.action.ACTION_RELEASE_SCANNER

OdooApp发送此 intent 以释放扫描头并停止接收扫码结果数据。

ACTION_CONTROL_SCANNER事件：

全称： com.honeywell.aidc.action.ACTION_CONTROL_SCANNER

OdooApp发送此 intent 以启动扫描程序。

扫码工作com.honeywell.aidc.extra.EXTRA_SCAN

设置为 true 以开始或继续扫描，设置为 false 可停止扫描，大多数方案只需要此 extra即可。

扫码准星com.honeywell.aidc.extra.EXTRA_AIM 

指定是打开还是关闭扫描仪瞄准器。这是可选的，默认值为 EXTRA_SCAN 的值。

扫码照明com.honeywell.aidc.extra.EXTRA_LIGHT

指定是打开还是关闭扫描仪照明。这是可选的，默认值为 EXTRA_SCAN 的值。

扫码解码com.honeywell.aidc.extra.EXTRA_DECODE 

指定是打开还是关闭解码操作。这是可选的，默认值为 EXTRA_SCAN的值。

Barcode解析完成广播事件：

OdooApp在成功扫描条码后收到PDA广播的Intent。其事件动作名称由 DPR_DATA_INTENT_ACTION属性参数决定。所有应用程序可以为此属性指定自己的操作名称，例如“com.odoo.app.action.BARCODE_DATA”，否则默认为"com.honeywell.scan.broadcast"广播动作

"data" (string): 解码数据字符串
"charset" (string) : 解码数据字符集
"dataBytes" (byte[]) : 原始条形码二进制数据
"timestamp" (string) : 解码数据时间戳
"aimId" (string): AIMID标准符号表示标识符
"codeId" (string) : Honeywell系统符号表示标识符
"version" (int) : 数据解码API版本号
"scanner" (未知) : 可能是连接外部扫码枪的名称

也可以在中国特色主菜单企业设置里进行全局的扫码设置，比如将扫码结果广播action修改为odoo.app.scan，此时默认的extras信息如下：

"Length" (number): 解码数据字符串长度
"scanner_result" (string): 解码数据字符串
"scanner_result_byte" (byte[]) : 原始二维码二进制数据
"special_keys" (string) : 特殊键码
"decodeTime" (number): 解码时间毫秒数
"lastDecodeTime" (number): 最后解码时间毫秒数
"AimModifier" (number): 未知，如49
"AimID" (number): AIMID标准符号表示标识符，如81
"CodeID" (number): Honeywell系统符号表示标识符，如二维码为115
"isFocus" (boolean): 是否焦点

还可以将原生扫描结果广播key修改成任意方便集成的名称，比如将标准key为data的最终解码结果扩展出一个新的code，前端就可以统一硬编码快捷获取扫码内容。

欧度软件安卓MainActivity核心参考代码：

package com.honeywell.sample.intentapisample; 
 
import android.content.BroadcastReceiver; 
import android.content.Context; 
import android.content.Intent; 
import android.content.IntentFilter; 
import android.support.v7.app.AppCompatActivity; 
import android.os.Bundle; 
import android.util.Log; 
import android.widget.TextView; 
 
public class MainActivity extends AppCompatActivity { 
    private static final String TAG = "IntentApiSample"; 
    private static final String ACTION_BARCODE_DATA = "com.honeywell.sample.action.BARCODE_DATA"; 
 
    /** 
     * Honeywell DataCollection Intent API 
     * Claim scanner 
     * Permissions: 
     *      "com.honeywell.decode.permission.DECODE" 
     */ 
    private static final String ACTION_CLAIM_SCANNER = 
"com.honeywell.aidc.action.ACTION_CLAIM_SCANNER"; 
 
    /** 
     * Honeywell DataCollection Intent API 
     * Release scanner claim 
     * Permissions: 
     *      "com.honeywell.decode.permission.DECODE" 
     */ 
    private static final String ACTION_RELEASE_SCANNER = 
"com.honeywell.aidc.action.ACTION_RELEASE_SCANNER"; 
 
    /** 
     * Honeywell DataCollection Intent API 
     * Optional. Sets the scanner to claim. If scanner is not available or if extra is not used, 
     * DataCollection will choose an available scanner. 
     * Values : String 
     *      "dcs.scanner.imager" : Uses the internal scanner 
     *      "dcs.scanner.ring" : Uses the external ring scanner 
     */ 
    private static final String EXTRA_SCANNER = "com.honeywell.aidc.extra.EXTRA_SCANNER"; 
 
    /** 
     * Honeywell DataCollection Intent API 
     * Optional. Sets the profile to use. If profile is not available or if extra is not used, 
     * the scanner will use factory default properties (not "DEFAULT" profile properties). 
     * Values : String 
     */ 
    private static final String EXTRA_PROFILE = "com.honeywell.aidc.extra.EXTRA_PROFILE"; 
 
    /** 
     * Honeywell DataCollection Intent API 
     * Optional. Overrides the profile properties (non-persistent) until the next scanner claim. 
     * Values : Bundle 
     */ 
    private static final String EXTRA_PROPERTIES = "com.honeywell.aidc.extra.EXTRA_PROPERTIES"; 
 
    private TextView textView; 
 
    private BroadcastReceiver barcodeDataReceiver = new BroadcastReceiver() { 
        @Override 
        public void onReceive(Context context, Intent intent) { 
            if (ACTION_BARCODE_DATA.equals(intent.getAction())) { 
                /* 
                These extras are available: 
                    "version" (int) = Data Intent Api version 
                    "aimId" (String) = The AIM Identifier
                    "charset" (String) = The charset used to convert "dataBytes" to "data" string 
                    "codeId" (String) = The Honeywell Symbology Identifier 
                    "data" (String) = The barcode data as a string 
                    "dataBytes" (byte[]) = The barcode data as a byte array 
                    "timestamp" (String) = The barcode timestamp 
                 */ 
 
                int version = intent.getIntExtra("version", 0); 
                if (version >= 1) { 
                    String aimId = intent.getStringExtra("aimId"); 
                    String charset = intent.getStringExtra("charset"); 
                    String codeId = intent.getStringExtra("codeId"); 
                    String data = intent.getStringExtra("data"); 
                    byte[] dataBytes = intent.getByteArrayExtra("dataBytes"); 
                    String dataBytesStr = bytesToHexString(dataBytes); 
                    String timestamp = intent.getStringExtra("timestamp"); 
 
                    String text = String.format( 
                            "Data:%s\n" + 
                            "Charset:%s\n" + 
                            "Bytes:%s\n" + 
                            "AimId:%s\n" + 
                            "CodeId:%s\n" + 
                            "Timestamp:%s\n", 
                            data, charset, dataBytesStr, aimId, codeId, timestamp); 
                    setText(text); 
                } 
            } 
        } 
    }; 
 
    @Override 
    protected void onCreate(Bundle savedInstanceState) { 
        super.onCreate(savedInstanceState); 
        setContentView(R.layout.activity_main); 
        textView = (TextView) findViewById(R.id.textView); 
    } 
 
    @Override 
    protected void onResume() { 
        super.onResume(); 
        registerReceiver(barcodeDataReceiver, new IntentFilter(ACTION_BARCODE_DATA)); 
        claimScanner(); 
    } 
 
    @Override 
    protected void onPause() { 
        super.onPause(); 
        unregisterReceiver(barcodeDataReceiver); 
        releaseScanner(); 
    } 
 
    private void claimScanner() { 
        Bundle properties = new Bundle(); 
 
        properties.putBoolean("DPR_DATA_INTENT", true); 
        properties.putString("DPR_DATA_INTENT_ACTION", ACTION_BARCODE_DATA); 
 
        sendBroadcast(new Intent(ACTION_CLAIM_SCANNER) 
                        .setPackage("com.intermec.datacollectionservice") 
                        .putExtra(EXTRA_SCANNER, "dcs.scanner.imager") 
                        .putExtra(EXTRA_PROFILE, "MyProfile1") 
                        .putExtra(EXTRA_PROPERTIES, properties) 
        ); 
    } 
 
    private void releaseScanner() { 
        sendBroadcast(new Intent(ACTION_RELEASE_SCANNER) 
                        .setPackage("com.intermec.datacollectionservice") 
        ); 
    } 

    private void setText(final String text) { 
        if (textView != null) { 
            runOnUiThread(new Runnable() { 
                @Override 
                public void run() { 
                    textView.setText(text); 
                } 
            }); 
        } 
    }

    private String bytesToHexString(byte[] arr) { 
        String s = "[]"; 
        if (arr != null) { 
            s = "["; 
            for (int i = 0; i < arr.length; i++) { 
                s += "0x" + Integer.toHexString(arr[i]) + ", "; 
            } 
            s = s.substring(0, s.length() - 2) + "]"; 
        } 
        return s; 
    } 
}

Honeywell系统符号表示标识符目录列表

Symbology
Code Id

DOTCODE

.

CODE1

1

MERGED_COUPON

;

CODE39_BASE32, CODE32, ITALIAN PHARMACODE, PARAF

<

LABELCODE_IV

>

LABELCODE_V

<

TRIOPTIC

=

KOREA_POST

?

INFOMAIL

,

EAN13_ISBN

`

SWEEDISH_POST

[

RM_MAILMARK

|

BRAZIL_POST

]

AUS_POST

A

BRITISH_POST

B

CANADIAN_POST

C

EAN8

D

UPCE

E

BC412

G

HAN_XIN_CODE

H

GS1_128

I

JAPAN_POST

J

KIX_CODE

K

PLANET_CODE

L

USPS_4_STATE, INTELLIGENT_MAIL

M

UPU_4_STATE, ID_TAGS

N

OCR

O

POSTNET

P

HK25, CHINA_POST

Q

MICROPDF

R

SECURE_CODE

S

TLC39

T

ULTRACODE

U

CODABLOCK_A

V

POSICODE

W

GRID_MATRIX

X

NEC25

Y

MESA

Z

CODABAR

a

CODE39

b

UPCA

c

EAN13

d

I25

e

S25 (2BAR and 3BAR)

f

MSI

g

CODE11

h

CODE93

i

CODE128

j

UNUSED

k

CODE49

l

M25

m

PLESSEY

n

CODE16K

o

CHANNELCODE

p

CODABLOCK_F

q

PDF417

r

QRCODE

s

MICROQR_ALT

-

TELEPEN

t

CODEZ

u

VERICODE

v

DATAMATRIX

w

MAXICODE

x

RSS

y

GS1_DATABAR

y

GS1_DATABAR_LIM 

{

GS1_DATABAR_EXP 

}

COMPOSITE  

y

AZTEC_CODE

z

霍尼韦尔安卓系统OdooApp数据扫码消息广播API
欧度仁杰 2024年8月9日
标签
android app barcode pda
我们的博客
存档
OdooPDA外设：霍尼韦尔MT5系列无线数据终端
霍盛工业科技智能无线通用手持终端安卓数据采集器盘点机