康耐视移动条码SDK for Android

智能手机作为条形码扫描设备的功能差异导致用户体验与专用扫描仪不同，影响了移动条形码扫描应用程序的设计。通过遵循一些简单的指导原则，您可以使用cmbSDK开发应用程序，这些应用程序在使用MX移动终端或移动设备的内置摄像头时以相同的方式工作。

• 若要在没有专用硬件触发器的情况下启动条形码扫描，请参见移动设备触发．
• 若要使用没有瞄准器的智能手机进行条码扫描，请参见移动设备瞄准．
• 要选择最合适的条形码扫描方向，请参见移动设备定位．
• 若要降低移动设备在执行图像分析和条形码解码时的CPU占用率，请参见优化移动设备性能．

CmbSDK使用一组默认选项用于移动设备的内置摄像头读取条形码。但是，cmbSDK不实现相机读取器的保存配置。这意味着每次启动使用相机阅读器的应用程序时，它都会使用相机阅读器的默认设置启动。有关默认设置的列表，请参见附录．

如果没有硬件触发器，移动设备必须使用替代方法来启动条形码扫描。cmbSDK支持三种方式触发条码扫描:

• 应用程序或工作流驱动的触发器:应用程序代码或应用程序的业务逻辑/工作流调用扫描模块。在简单的编程术语中，它调用一个函数startScanner ()．
• 虚拟触发:要启动或停止扫描过程，应用程序在屏幕上提供了一个按钮。根据应用程序的设计，您需要按住虚拟按钮以保持扫描仪运行，这将调用扫描模块。
• 模拟触发:按下其中一个音量降低按钮来启动或停止扫描过程，就像在专用扫描仪上扣动扳机一样。

内置摄像头在移动设备的显示屏上提供了条形码瞄准的实时流预览。重新定位移动设备，直到条形码出现在内置摄像头的视野中，应用程序对其进行解码。CmbSDK提供了一个内置的预览控件，可以部分或全屏显示，也可以纵向或横向显示。

cmbSDK还支持无源瞄准器:连接到移动设备或其外壳上的设备，使用设备的LED闪光灯作为光源来投射瞄准或瞄准模式。移动设备可以投射一个类似于专用扫描仪的瞄准器模式，因此不需要实时预览。然而，使用LED闪光灯作为瞄准器，一般的扫描照明是不可用的。

cmbSDK支持纵向方向、横向方向和自动旋转，以显示条形码预览和扫描方向。移动设备可以扫描大多数条形码，而不考虑应用程序和/或移动设备的方向。

肖像或风景	画像只有	景观只有
大多数条形码既可以纵向扫描，也可以横向扫描。	大多数定义良好和中等大小的条形码可以纵向扫描，这是持有移动设备最自然的方式。 示例:QR，数据矩阵，Maxicode。	长、密集或形状不好的条形码更容易在具有更高分辨率的横向上扫描。 例子:PDF417。

移动设备是条码解码的理想平台。cmbSDK针对移动环境进行了优化，但图像分析和条形码解码仍然是CPU密集型活动。由于这些进程与移动操作系统(OS)、服务和其他应用程序共享移动设备的CPU，因此这些进程优化了条形码扫描应用程序，并将其限制为仅使用它们所需的cmbSDK特性。

优化应用程序:

• 仅对应用程序需要扫描的条形码类型启用解码。cmbSDK支持解码近40种不同的条形码类型和子类型，从而导致低性能和意外错误。
• 不要同时启用某些符号和/或高级功能。
• 优化相机分辨率。cmbSDK默认使用高清图像进行条码解码。
• 使用适当的解码器努力级别。cmbSDK具有可配置的努力级别，以控制它执行图像分析的积极程度。cmbSDK使用默认值(级别2)，这对大多数条形码来说是足够的。使用更高的级别可以对质量较差的条形码进行更好的解码，从而导致性能变慢。

在初始化cmbSDK以与移动设备的内置摄像头一起使用时，默认情况下不启用条形码符号。

安装Android cmbSDK

1. 下载康耐视移动条码SDK for Android从康耐视移动条码扫描器解决方案页面。
2. 启动Android Studio并将SDK AAR文件作为模块添加到项目中:
   
   -从Android Studio开始v4.2.1以后，. aar文件不能直接作为模块导入。您需要导入Gradle或Eclipse项目:
   1. 右键单击应用程序模块，选择新建>模块>导入．

   2. 在Source目录字段中浏览包含构建的cmbsdklib-release目录。Gradle文件和cmbsdklib-release。Aar文件在里面。在模块名称字段中，您应该看到: cmbsdklib-release,并点击完成．

   
   -如果你使用的是旧版本的Android Studio，你可以直接导入。aar文件:
   1. 右键单击应用程序模块，选择新建>模块>导入。jar /。AAR包，并单击下一个．

   2. 浏览cmbsdklib-release。2 .在“文件名”字段中，单击完成．

3. 在新模块可用后，右键单击应用程序模块，选择开放模块设置，并选择依赖关系选项卡。

   

4. 单击+在“声明的依赖项”对话框顶部签名，并选择3模块依赖性．
5. 从弹出窗口中选择cmbsdklib-release并单击好吧，使得cmbsdklib-release模块可以在依赖关系选项卡。

6. 安装MX Connect应用程序玩店与MX移动终端通信。如果你的应用程序的targetSDK是30或更高，你将需要添加以下查询到你的应用程序的清单，以允许它通过MX connect连接到MX终端:

      .

要在没有MX移动终端的移动设备上使用cmbSDK进行条形码扫描，需要安装许可密钥。如果许可证密钥缺失，将出现星号而不是扫描结果。

有关如何获取许可证密钥(包括30天试用许可证)的信息，请与您的康耐视销售代表联系。

Android:

1. 在获得许可密钥后，在应用程序的AndroidManifest.xml文件的application标签下添加以下一行:

2. 用您的许可密钥替换YOUR_MX_MOBILE_LICENSE。

在创建新实例时，还可以通过复制下面的文本来添加许可密钥ReaderDevice．

case PhoneCamera: readerDevice = readerDevice。getPhoneCameraDevice(this, param_cameraMode, PreviewOption.DEFAULTS, null, "SDK_KEY");

1. 安装MX连接应用程序从Play商店。这个应用程序可以让你的手机无缝连接到康耐视MX阅读器。

2. 安装cmbSDK对你的项目。

3. 使用DataManSystem.createDataManSystemForMXDevice ()factory方法创建一个DatamanSystem对象。

4. 删除:
   • 所有DataManSystem.createDataManSystemOverUsb ()方法。
   • 所有DataManSystem.createDataManSystemOverUsbAccessory ()方法。
   • USB_ DEVICE-ATTACHED和USB_ACCESSORY_ATTACHED意图过滤器和来自AndroidManifest.xml文件的元数据。
   • xml文件夹中的USB和附件描述符xml文件。

CmbSDK为支持的扫描设备(MX移动终端和移动电话的摄像头)提供了一个高级的抽象接口。

应用程序和条形码扫描设备之间的主要接口是ReaderDevice类。的ReaderDevice类表示设备的抽象层，处理所有通信和必要的硬件管理，例如使用智能手机进行扫描。

使用cmbSDK的步骤如下:

1. 属性创建实例ReaderDevice使用要使用的扫描设备类型初始化(MX读者或相机的读者）.

2. 连接到ReaderDevice您创建的实例。

3. 配置ReaderDevice实例，如果需要的话。

4. 开始扫描。

• 如果MX移动终端由于超时或电池耗尽而断开连接，则需要重新配置。为了避免这种情况，您可以保存配置。
• 您的应用程序可以同时使用MX移动终端和相机扫描。在这种情况下，您必须在断开与当前设备的连接后建立到另一个设备的新连接。您可以检查我们的示例应用程序，以了解它是如何工作的。

执行以下步骤设置并开始使用cmbSDK:

1. 导入以下包成员，或者只导入你使用的类:

   进口com.cognex.dataman.sdk。*导入com.cognex.mobile.barcode.sdk.*

2. 根据你的需要构建你的UI，但要考虑以下几个方面:

• 你必须决定你是想显示部分或全屏(这是默认的)相机预览。你需要一个ViewGroup容器使用部分预览，例如RelativeLayout。全屏预览不需要额外的容器。

我们的示例应用程序(你可以在cmbSDK包中找到)使用全屏预览。要更改示例应用程序以使用部分视图，请添加以下内容使用在最后ConstraintLayout在activity_scanner.xml文件。使用此布局广告ViewGroup读取设备构造函数中的参数(getPhoneCameraDevice)当读取设备初始化．

• 要显示上次扫描的图像，可以使用ImageView需要容器。
• 若要将扫描结果显示为文本，可以使用TextView是必要的。

3. 设置以下接口来监控阅读器的连接状态，并接收有关已读代码的信息:

   公共类ScannerActivity扩展了AppCompatActivity，实现了OnConnectionCompletedListener, ReaderDeviceListener, ActivityCompat。OnRequestPermissionsResultCallback {....//连接方法已经完成，在这里你可以看到是否有建立连接的错误@Override public void onConnectionCompleted(ReaderDevice ReaderDevice, Throwable error){//如果我们有有效的连接错误参数将为null，/ /否则就是错误,告知我们问题时,我们已经连接到读者设备如果(错误! = null){/ /要求相机允许如果必要(错误instanceof CameraPermissionException) ActivityCompat.requestPermissions (((ScannerActivity)), [] {Manifest.permission新字符串。相机},REQUEST_PERMISSION_CODE);updateUIByConnectionState ();}} //当与self连接时调用。readerDevice已更改。// readerDevice只能在ConnectionState中使用。Connected" state @Override public void onConnectionStateChanged(ReaderDevice reader) {clearResult();if (reader.getConnectionState() == ConnectionState.Connected){//我们刚刚连接，所以现在配置设备我们想要它configureReaderDevice();} isScanning = false;updateUIByConnectionState (); } // This is called after scanning has completed, either by detecting a barcode, canceling the scan by using the on-screen button or a hardware trigger button, or if the scanning timed-out @Override public void onReadResultReceived(ReaderDevice readerDevice, ReadResults results) { clearResult(); if (results.getSubResults() != null && results.getSubResults().size() > 0) { for (ReadResult subResult : results.getSubResults()) { createResultItem(subResult); } } else if (results.getCount() > 0) { createResultItem(results.getResultAt(0)); } isScanning = false; btnScan.setText("START SCANNING"); resultListAdapter.notifyDataSetChanged(); } // This is called when a MX-1xxx device has became available (USB cable was plugged, or MX device was turned on), // or when a MX-1xxx that was previously available has become unavailable (USB cable was unplugged, turned off due to inactivity or battery drained) @Override public void onAvailabilityChanged(ReaderDevice reader) { if (reader.getAvailability() == Availability.AVAILABLE) { connectToReaderDevice(); } else if (reader.getAvailability() == Availability.UNAVAILABLE) { AlertDialog.Builder alert = new AlertDialog.Builder(this); alert .setTitle("Device became unavailable") .setPositiveButton("OK", null) .create() .show(); } }

4. 实例化一个ReaderDevice对象。

使用以下工厂方法初始化MX阅读器的Reader Device对象:

case MX: readerDevice = readerDevice . getmxdevice (this);//当MX设备可用/不可用时监听if (!availabilityListenerStarted) {readerDevice.startAvailabilityListening();availabilityListenerStarted = true;｝

MX移动终端的可用性可能会在设备打开或关闭，或者连接或断开USB线时发生变化。您可以使用以下方法处理这些更改ReaderDeviceListener接口方法:

onAvailabilityChanged(ReaderDevice reader);

建议使用MX移动终端扫描条形码。但是，cmbSDK还支持使用移动设备的内置摄像头。这包括支持可选的外部瞄准器或照明，以及自定义直播预览的外观。

若要使用移动设备的内置摄像头扫描条形码，请初始化ReaderDevice对象使用getPhoneCameraDevice静态方法。相机读取器初始化时有几个选项。需要配置以下参数:

• 上下文
• CameraMode
• PreviewOption
• ViewGroup
• RegistrationKey
• CustomData

的上下文参数提供对当前活动的引用。

的CameraMode中定义的CameraMode类型CameraMode.java它接受下表中列出的值之一。

这些模式为读者提供以下默认设置:

• 缩放功能是可用的，一个按钮来控制它是可见的直播流预览(如果显示)。
• 模拟硬件触发器(音量控制按钮)已禁用。
• 当startScanning ()，则开始解码过程。

根据所选择的模式，设置额外的照明选项和行为，也列在表格中。

价值	描述	照明	直播预览
NO_AIMER	初始化阅读器以在移动设备屏幕上使用实时流预览，以便用户可以将条形码定位在摄像机的视野内以进行检测和解码。如果移动设备没有瞄准配件，请使用此模式。	照明是可用的，一个按钮来控制它是可见的直播流预览。	显示
		如果命令被发送给阅读器进行瞄准器控制，则它们将被忽略。
PASSIVE_AIMER	初始化读取器以使用被动瞄准器。在这种模式下，设备屏幕上没有直播预览，因为瞄准模式是投影的。	照明是不可用的，并且直播预览没有照明按钮。	不显示
		如果命令被发送到阅读器进行照明控制，它们将被忽略，因为在这种模式下，假设移动设备的内置LED被用于瞄准器。
FRONT_CAMERA	初始化阅读器以使用移动设备的前置摄像头(如果可用)。使用这种配置时要小心，因为大多数前置摄像头都没有自动对焦和照明，提供的图像分辨率也明显较低。照明在此模式下不可用。	使用前置摄像头。	显示
		照明是不可用的，实时流预览没有照明按钮。
		如果命令被发送到阅读器用于瞄准器或照明控制，它们将被忽略。

的PreviewOption参数的类型为PreviewOption中定义的PreviewOption.java，用于更改读取器的默认值或覆盖从选定对象派生的默认值CameraMode．您可以指定以下选项:

价值	描述
违约	接受CameraMode设置的所有默认值。
NO_ZOOM_BUTTON	隐藏实时流预览上的缩放按钮，防止用户调整移动设备相机的缩放。
NO_ILLUMINATION_BUTTON	隐藏直播预览上的照明按钮，防止用户切换照明。
HARDWARE_TRIGGER	启用模拟硬件触发器(音量降低按钮)，以便在移动设备上开始扫描。这个按钮只在按下时才开始扫描，不需要像专用扫描仪的触发器那样按住它，第二次按下它也不会停止扫描过程。
停顿了一下	如果使用实时流预览，则在startScanning ()方法调用，但是直到用户按下屏幕上的按钮开始扫描过程时，阅读器才开始解码。
ALWAYS_SHOW	即使选择了瞄准模式(例如CameraMode == PASSIVE_AIMER)，也会强制显示实时流预览。
HIGH_RESOLUTION	使用更高分辨率的设备摄像头，在支持它的设备上将默认的1280x720分辨率更改为1920x1080，在不支持它的设备上更改为默认分辨率。这可以帮助扫描小条形码，但增加解码时间，因为每帧有更多的数据需要处理。
HIGH_FRAME_RATE	使用设备的相机在60 FPS，而不是默认的30 FPS，以提供一个更流畅的相机预览。
SHOW_CLOSE_BUTTON	在局部视图中显示关闭按钮。
KEEP_PREVIEW_IN_PAUSED_STATE	读取或超时后保持预览暂停状态。

的ViewGroup(可选)参数指定直播流预览的容器。如果该参数为空零时，使用全屏预览。

的RegistrationKey(可选)参数用于使用您拥有的许可密钥授权您的SDK

的CustomData(可选)参数用于自定义跟踪

例子

创建一个没有瞄准器，没有缩放按钮，并使用软触发器的阅读器:

readerDevice =读写设备。getPhoneCameraDevice(this, CameraMode.NO_AIMER, PreviewOption.NO_ZOOM_BUTTON | PreviewOption.PAUSED);

这开始预览扫描仪暂停和软触发按钮切换扫描。按下软触发按钮后，预期的预览外观是这样的:

由于设置了活动符号，图像中的取景器具有活动扫描表面。详情请参见使象征学．

对于Android 6.0及以上版本，您需要向用户请求访问移动设备内置摄像头的权限。

如果由于权限问题而无法打开摄像机，则onConnectionCompleted (readerDevice错误)回调包含CameraPermissionException在error参数中。方法检查此异常类型运算符operator和请求活动中的权限。

if (error instanceof CameraPermissionException) ActivityCompat.requestPermissions(((ScannerActivity) this)， new String[]{Manifest.permission. permission. exception)相机},REQUEST_PERMISSION_CODE);

您需要实现ActivityCompat。OnRequestPermissionResultCallback接口来捕获用户权限结果。
处理用户的响应onRequestPermissionResult(…)，您可以使用以下代码重试连接手机摄像头:

@Override public void onRequestPermissionsResult(int requestCode， @NonNull String[] permissions， @NonNull int[] grantResults){//权限请求检查结果。如果用户允许，则连接readerDevice If (requestCode == REQUEST_PERMISSION_CODE) {If (grantResults。长度> 0 && grantResults[0] == packagemanager . permission_granting) {if (readerDevice != null && readerDevice. getconnectionstate () != ConnectionState.Connected) readerDevice.connect(ScannerActivity.this);} else {if (ActivityCompat.shouldShowRequestPermissionRationale((ScannerActivity) this)， Manifest.permission.CAMERA)) {AlertDialog。生成器生成器=新的AlertDialog.Builder(this) . setmessage("你需要允许访问相机"). setpositivebutton ("OK"，新的DialogInterface. onclicklistener(){@覆盖公共无效onClick(DialogInterface DialogInterface, int i) {activitycompat.com requestpermissions(扫描活动。this, new String[]{Manifest.permission。相机},REQUEST_PERMISSION_CODE);}}) .setNegativeButton("取消"，null);AlertDialog dialog = builder.create();dialog.show ();} } } }

连接前，设置ReaderDeviceListener对象来接收事件:

readerDevice.setReaderDeviceListener(这个);

具体操作请参见步骤3设置您的应用程序来使用康耐视移动条码SDK的Android．

此外，您可以启用从阅读器发送最后触发的图像和SVG:

readerDevice.enableImage(真正的);readerDevice.enableImageGraphics(真正的);

方法初始化后调用connect方法ReaderDevice以及设置一个侦听器方法来处理来自阅读器的响应。connect方法的参数为OnConnectionCompletedListener参数:

//确保设备已打开并准备readerDevice.connect(ScannerActivity.this);

下面的侦听器方法使用newReaderDevice状态信息:

onConnectionStateChanged(ReaderDevice reader);onConnectionCompleted(ReaderDevice reader, Throwable err)

的onConnectionCompleted方法作为connect的参数传递，也会在连接过程完成时调用。如果出现连接错误，此方法将提供Throwable对象。

连接到扫描设备后，您可能需要更改其某些设置。CmbSDK提供了一组高级的、与设备无关的api，用于设置和检索设备的当前配置。

方法，可以使用正确配置的读取器开始扫描条形码startScanning方法。ReaderDevice类:

readerDevice.startScanning ();

• 如果使用MX移动终端，您可以按下设备上的触发按钮来打开扫描仪并读取条形码。
• 如果使用摄像头读取器，cmbSDK将启动摄像头，显示配置的实时流预览，并开始分析来自视频流的帧，寻找配置的条形码符号。

您可以使用以下命令停止扫描:

readerDevice.stopScanning ();

当满足下列条件之一时，扫描停止:

• 阅读器发现并破译了条形码。
• 在直播预览屏幕上，您松开了触发器或按下了停止按钮。
• 相机读取器超时，没有找到条形码。
• 应用程序调用stopScanning ()方法。

的ReadResults可迭代结果集合对象中成功解码条形码时，将收到一个ReadResults可迭代结果集合对象ReaderDevice侦听器方法。的onReadResultReceived侦听器方法被调用是因为读取器已解码条形码或扫描过程已完成。

例子

//在扫描完成后调用，通过检测条形码，通过使用屏幕按钮或硬件触发按钮取消扫描，或者如果扫描超时@Override公共无效onReadResultReceived(ReaderDevice ReaderDevice, ReadResults results) {clearResult();if (results.getSubResults() != null && results.getSubResults().size() > 0) {for (ReadResult subResult: results.getSubResults()) {createResultItem(subResult);}} else if (results.getCount() > 0) {createResultItem(results.getResultAt(0));} isScanning = false;btnScan。setText(“开始扫描”);resultListAdapter.notifyDataSetChanged ();｝

CmbSDK不启用任何象征学默认情况下，通过移动设备的内置摄像头读取条形码。必须启用应用程序需要扫描的所有条形码符号，以实现最佳扫描性能。详情请参见优化移动设备性能．

控件的以下方法可以启用单个符号ReaderDevice类:

readerDevice.setSymbologyEnabled(最终的符号学符号学，最终布尔启用，最终的OnSymbologyListener监听器)DATAMATRIX, true, null);readerDevice.setSymbologyEnabled(象征。UPC_EAN, true, null);

此方法中用于符号参数的所有符号都可以在ReaderDevice.java．

例子

/*启用二维码扫描*/ readerDevice.setSymbologyEnabled(符号。QR, true, null);

你也可以使用相同的方法禁用符号:

/ *禁用Code 25扫描*/ readerDevice.setSymbologyEnabled(符号。C25, false, null);

可以实现的方法OnSymbologiesListener检查符号改变的结果:

@Override public void onSymbologyEnabled(ReaderDevice reader, symsymology symbolology, Boolean enabled, Throwable error) {if (error != null){/*不成功可能是当前设备不支持符号，或者ReaderDevice和MX设备之间的连接有问题*/}否则{// Success}}

如果你的阅读设备配备了照明灯，你可以控制它们:当扫描开始时，你可以打开或关闭它们。使用Reader Device对象的以下方法:

readerDevice。setLightsOn(true, null);

的接口方法OnLightsListener，这是该方法的第二个参数。

公共类ScannerActivity扩展AppCompatActivity实现....OnLightsListener……{…@覆盖公共无效onLightsOnCompleted(ReaderDevice reader, Boolean on, Throwable error) {if (error != null){//不成功}else {// Success}}}}

如果使用移动设备的内置摄像头作为读取设备，您可以配置缩放级别及其使用方式。有三个缩放级别:

• 正常:未放大(100%)
• 一级缩放(Android默认为150%)
• 二级缩放(Android默认300%)

的设置相机。变焦-PERCENT [100-MAX] [100-MAX]命令用于配置两个级别的缩放百分比。100不能放大，MAX(最高可达1000)会尽可能放大设备所能放大的范围。第一个参数用于设置1级缩放，第二个参数用于设置2级缩放。

控件可以检查当前的缩放设置让相机。变焦-PERCENT命令，该命令返回两个值:一级缩放和二级缩放。

例子

readerDevice.getDataManSystem()。sendCommand(“设置相机。缩放比例250 500”);

获取/设置相机。变焦0 - 2另一个设置缩放级别或返回实际设置的命令。SET命令的取值包括:

• 0 -正常(未放大)
• 1 - 1级缩放
• 2 - 2级缩放

您可以在扫描之前或甚至在扫描期间调用此命令，然后缩放上升到配置的级别。如果扫描完成，该值将重置为正常行为(0)。

例子

readerDevice.getDataManSystem()。sendCommand(“设置相机。放大2”);

当使用移动设备的摄像头时，cmbSDK允许您在预览容器中或全屏查看摄像头预览。此预览还包含一个可定制的覆盖。cmbSDK相机覆盖功能按钮缩放，闪烁和关闭扫描仪，以及一个进度条指示扫描超时。

使用cmbSDK v2.0中最初使用的遗留摄像头覆盖。x而且ManateeWorks SDK, use this property from MWOverlay before initializing the readerDevice:

MWOverlay。overlayMode = MWOverlay.OverlayMode.OM_LEGACY;

当使用cmbSDK覆盖时:

1. 将Resources/layout目录中的布局文件复制到项目中必威随行版官网并修改它们。使用cmb_scanner_partial_view.xml如果扫描是在容器内启动的(部分视图)，则使用cmb_scanner_view.xml全屏启动扫描。
2. 根据需要修改布局。例如，您可以更改视图的大小、位置或颜色，删除视图并添加自己的视图，就像叠加图像一样。

cmbSDK和遗留的覆盖都允许您更改缩放和闪光按钮上使用的图像，如果您的图像具有与cmbSDK使用的名称相同的名称。您可以在参考资料/中找到cmbSDK中使用的图像和名称必威随行版官网drawable-mdpi而且drawable-hdpi目录。虽然其他分辨率是可选的，但这两个目录必须包含具有正确名称的图像，以便cmbSDK显示正确的图像。

cmbSDK和遗留的覆盖层都允许您更改检测到条形码时显示的矩形的颜色和宽度。

例子:

MWOverlay。locationLineColor = Color.YELLOW;MWOverlay。locationLineWidth = 6;

康耐视扫描设备实现DataMan控制命令(DMCC)，用于配置和控制设备。设备的每个功能都可以使用这种基于文本的语言进行控制。API提供了向设备发送DMCC命令的方法。存在用于设置和查询配置属性的命令。

的附录包括完整的DMCC参考相机阅读器。

下面的例子展示了不同的DMCC发送到设备进行更高级的配置。

例子

//修改扫描方向为全向readerDevice.getDataManSystem()。sendCommand("SET DECODER.1D-SYMBOLORIENTATION 0"， ScannerActivity.this);//修改直播预览的扫描超时时间为10秒readerDevice.getDataManSystem()。sendCommand(“设置解码器。MAX-SCAN-TIMEOUT 10"， scaneractivity .this);

中调用DMCC查询命令并接收它们的响应OnResponseReceivedListener.onResponseReceived ()方法。

//获取连接的设备类型readerDevice.getDataManSystem()。sendCommand(“设备。的名字", new OnResponseReceivedListener() { @Override public void onResponseReceived(DataManSystem dataManSystem, DmccResponse dmccResponse) { if (dmccResponse.getError() != null) { // Unsuccessful Log.e("DMCC_ERR", “GET DEVICE.NAME failed”,dmccResponse.getError()); } else { // Success - Use the following result fields: //int mResponseId = dmccResponse.getResponseId(); //String mPayLoad = dmccResponse.getPayLoad(); //byte[] mBinaryData = dmccResponse.getBinaryData(); } } ); }

CmbSDK包括一个将设备重置为默认设置的方法。对于MX移动终端，默认配置为已保存的配置。对于内置摄像头，默认设置为附录，其中没有启用任何符号。

要重置设备，添加:

readerDevice.resetConfig(空);

在使用MX移动终端时，我们可以区分三种状态:

• 工厂默认设置
• 保存配置:当在设备和CONFIG上设置了不同的配置时。SAVE DMCC被叫来了。
• 会话配置:当您对保存的配置进行更改时，更改将一直有效，直到MX移动终端重新启动。如果它被重新启动，它将具有保存的配置状态。

方法监视此异步方法的完成情况OnResetConfigListener接口，可选参数。

公共类ScannerActivity扩展了Activity，实现了....OnResetConfigListener……{…@Override public void onResetConfigCompleted(ReaderDevice reader, Throwable error) {if (error != null){//不成功}else {// Success}}

成功读取条形码时，将onReadResultReceived方法创建并返回一个ReadResult对象。在单个图像或帧上成功读取多个条形码的情况下，多个ReadResult对象返回ReadResult对象。

ReadResult类具有描述条形码读取结果的属性:

• GoodRead ()(boolean):表示读取是否成功
• 得到ReadString ()(String):解码后的条形码为字符串
• 得到图像()(位图):解码器处理的图像/帧
• 得到ImageGraphics ()(String):条形码作为SVG数据的边界路径
• Xml ()(字符串):解码器返回的原始XML
• 得到标记(Symbology):条形码的符号类型。中定义的枚举ReaderDevice.java。

当扫描结束而未成功读取时，aReadResult返回与goodRead属性设置为false。

属性中填充image和imageGraphics属性ReadResult对象，设置相应的enableImage ()和/或enableImageGraphics ()的属性ReaderDevice对象。

要从扫描的条形码中访问原始字节，可以使用XML属性。字节被存储为“full_string”标签下的Base64字符串。该示例展示了如何使用XML解析器从XML属性提取原始字节。

例子

try {XmlPullParserFactory factory = XmlPullParserFactory. newinstance ();factory.setNamespaceAware(真正的);XmlPullParser xpp = factory.newPullParser();字符串标签= "";//原始字节将存储在这个变量byte[] bytes中;xpp。setInput(新StringReader (result.getXml ()));int eventType = xpp.getEventType();while (eventType != XmlPullParser.END_DOCUMENT) {if (eventType == XmlPullParser.START_TAG) {tag = xpp.getName();} else if (eventType == XmlPullParser. xml)TEXT && tag.equals("full_string")) { String base64String = xpp.getText(); // Get the bytes from the base64 string here bytes = Base64.decode(base64String, Base64.DEFAULT); break; } else if (eventType == XmlPullParser.END_TAG && tag.equals("full_string")) { tag = ""; break; } eventType = xpp.next(); } } catch (Exception e) { e.printStackTrace(); }

默认情况下，图像和SVG结果是禁用的，这意味着在扫描时ReadResults对应的属性中不包含任何数据。

要启用图像结果，请调用enableImage ()方法。ReaderDevice对象:

readerDevice.enableImage(真正的);

要启用SVG结果，请调用enableImageGraphics ()方法ReaderDevice对象:

readerDevice。enableImageGraphics(真正的);

如果设备由于电池电量不足或手动断开线缆而断开连接，则可以通过onConnectionStateChanged ()方法ReaderDeviceListener接口。

下表列出了使用内置摄像头进行条码扫描时cmbSDK支持的各种DMCC命令。

获取/设置	命令	参数(年代)	描述	默认值
获取/设置	电池。负责		以百分比的形式返回设备的当前电量。	N/A
	哔哔的声音		播放“哔”声(音)。	N/A
获取/设置	哔哔的声音。好	(0 - 3) (0 - 2)	设置嘟嘟声的数量(0-3)和嘟嘟声/音调(0- 2，低，中，高)。对于内置摄像头，只有一个单一的哔哔声，不支持螺距控制。因此，0 1将提示音关闭，11 1将提示音打开。	11 1(打开哔声)
获取/设置	相机。变焦	0 - 2	SET命令可能的值为:0 - normal(未缩放)，1 -缩放级别1,2 -缩放级别2。此缩放级别在扫描期间使用。扫描结束时，它重置为0。	N/A	x
获取/设置	相机。变焦-PERCENT	[100 - max] [100 - max)	设置/返回1级缩放(Android默认150%，iOS默认200%)，以及2级缩放(Android默认300%，iOS默认400%)。 注意:相机需要从sdk启动至少一次，以获得适当的最大变焦(max)值	N/A	x
获取/设置	CODABAR。CODESIZE	ON最小最大值 OFF最小最大值	接受任何长度的Codabar。 设置可接受的Codabar的最小/最大长度。	N/A	X X
获取/设置	CODABAR。QZ-SIZE	0 - 100	安静区单一严格大小。	50
获取/设置	CODABAR。验证	On | off	打开/关闭Codabar条形码验证。	在	X
获取/设置	C11。CHKCHAR	On | off	打开/关闭代码11检查数字。	从	X
获取/设置	C11。CHKCHAR-OPTION	1 2	需要单个校验和。需要双重校验和。	1	X X
获取/设置	C11。CODESIZE	ON最小最大值 OFF最小最大值	接受任何长度代码11。 设置接受代码11的最小/最大长度。	N/A	X X
获取/设置	C11。QZ-SIZE	0 - 100	安静区单一严格大小。	50
获取/设置	C11。验证	On | off	打开/关闭Code 11条形码的验证。	在	X
获取/设置	C128。QZ-SIZE	0 - 100	安静区单一严格大小。	50
获取/设置	C128。验证	On | off	打开/关闭代码128条形码的验证。	在	X
获取/设置	这件。CODESIZE	ON最小最大值 OFF最小最大值	接受任何长度代码25。 设置接受的代码25的最小/最大长度。	N/A	X X
获取/设置	这件。QZ-SIZE	0 - 100	安静区单一严格大小。注意C25。QZ-SIZE而且I2O5。QZ-SIZE是相机API的相同设置。	50
获取/设置	这件。验证	On | off	打开/关闭代码25和交叉的5个条形码中的2个的验证。	在	X
获取/设置	C39。美国信息交换标准代码	On | off	打开/关闭Code 39扩展ASCII。	从
获取/设置	C39。CODESIZE	ON最小最大值 OFF最小最大值	接受任何长度代码39。 设置接受Code 39的最小/最大长度。	N/A
获取/设置	C39。CHKCHAR	On | off	打开/关闭代码39检查数字	从
获取/设置	C39。QZ-SIZE	0 - 100	安静区单一严格大小。	50
获取/设置	C39。验证	On | off	打开/关闭Code 39条形码的验证。	在	X
获取/设置	C93。美国信息交换标准代码	On | off	打开/关闭代码93扩展ASCII	从	X
获取/设置	C93。CODESIZE	ON最小最大值 OFF最小最大值	接受任何长度代码93。 设置接受的代码93的最小/最大长度。	N/A
获取/设置	C93。验证	On | off	打开/关闭代码93条形码的验证。	从	X
获取/设置	COM。DMCC-HEADER	0 1	设置或获取扩展模式中使用的标头选项。	0
获取/设置	COM。DMCC-RESPONSE	0 1	DMCC响应格式。1:扩展。	0:默认为静默。
	配置。默认的		将大多数相机API设置重置为默认值，除了那些未重置的设置(见附录B)。要重置所有设置，请使用DEVICE.DEFAULT。	N/A
	配置。保存		将当前配置保存到非易失性内存(仅MX-1xxx)。注意，当MX关机或进入睡眠模式时，当设备唤醒时，最后保存的配置将恢复。	N/A
	配置。恢复		从非易失性内存中恢复保存的配置(仅限于MX-1xxx)。	N/A
获取/设置	数据。结果类型	0 1 2 4 8	指定要返回的结果(多个值的和): 0—无 1 -文本字符串结果(默认) 2 - XML结果 4 - XML统计 8 -扫描图像(见image。*命令)	1
获取/设置	DATABAR。扩大	On | off	打开/关闭数据库扩展符号。	从
获取/设置	DATABAR。有限的	On | off	打开/关闭DataBar Limited符号。	在
获取/设置	DATABAR。集团 DATABAR。RSS14	On | off	打开/关闭DataBar GROUP(在cmbSDK 2.4.1之前称为RSS14)符号。	在	X
获取/设置	DATABAR。RSS14STACK	On | off	打开/关闭DataBar RSS14堆叠符号。cmbSDK v2.4.1已弃用，使用DATABAR。集团。	从	X
获取/设置	DATABAR。验证	在	打开/关闭数据库条形码验证。	在	X
获取/设置	DECODER.1D——SYMBOLORIENTATION	0 1 2 3.	使用全向扫描定位。 使用水平和垂直扫描方向。 使用垂直扫描方向。 使用水平扫描方向。	1
获取/设置	译码器。努力	1 - 5	设置图像分析/解码的努力级别。缺省值是2。请勿使用4-5进行在线扫描。	2	X
获取/设置	译码器。MAX-SCAN——超时	0 - 120	设置直播预览的超时时间。当达到超时时，解码暂停;直播预览将继续在屏幕上显示。	60	X
得到	译码器。MAX-THREADS		返回设备支持的最大CPU线程数。	N/A	X
获取/设置	译码器。线色	(1-MAX)	指定扫描程序在扫描过程中可以使用的最大CPU线程数。	设备支持的最大CPU线程数	X
	设备。默认的		重置设备(包括摄像头API)设置为默认值(见附录B)。	N/A
得到	设备。FIRMWARE-VER		获取设备固件版本。	N/A
得到	设备。ID		返回由康耐视分配给扫描设备的设备ID。 对于内置相机，SDK返回53。	N/A
获取/设置	设备。的名字		返回分配给设备的名称。默认情况下，这是“MX-”加上DEVICE.SERIAL-NUMBER的最后6位数字。	“MX-”+ DEVICE的后六位数字。序列号
得到	设备。串行-数		返回设备的序列号。对于内置相机，SDK分配一个伪随机数。	N/A
得到	设备。类型		返回由康耐视分配给扫描设备的设备名称。对于内置相机，SDK返回“MX-Mobile”。	N/A
获取/设置	的焦点。FOCUSTIME	清廉	设置相机的自动对焦周期(相机应该尝试重新对焦的频率)。	3.
获取/设置	I2O5。CHKCHAR	On | off	将交错的5个检查数字中的2个打开/关闭。	从
获取/设置	I2O5。CODESIZE	ON最小最大值 OFF最小最大值	接受任意长度交错2 / 5。 设置可接受的5个交错2的最小/最大长度。	N/A	X X
获取/设置	I2O5。QZ-SIZE	0 - 100	安静区单一严格大小。注意C25。QZ-SIZE而且I2O5。QZ-SIZE是相机API的相同设置。	50	X
获取/设置	I2O5。验证	On | off	打开/关闭交错的2 / 5和代码25条形码的验证。	在	X
获取/设置	的形象。格式	0 1 2	扫描器以位图格式返回图像结果。 扫描器以JPEG格式返回图像结果。 扫描仪返回PNG格式的图像结果。	1 (JPEG)
获取/设置	的形象。质量	10、15、20、……90	指定JPEG图像质量。	50
获取/设置	的形象。大小	0 1 2 3.	扫描仪返回全尺寸图像。 扫描仪返回1/4大小的图像。 扫描仪返回1/16大小的图像。 扫描仪返回1/62大小的图像。	1(1/4号)
获取/设置	光。瞄准手	0 - 1	禁用/启用瞄准器(当扫描仪启动时)。	默认基于cameraMode: 0: NoAimer和FrontCamera 1:被动瞄准器和主动瞄准器
获取/设置	光。瞄准手-TIMEOUT	0 - 600	Aimer超时时间(秒)。	N/A
获取/设置	光。内部,使	On | off	启用/禁用照明(当扫描仪启动时)。	从
获取/设置	MSI。CHKCHAR	On | off	打开/关闭MSI Plessey检查数字。	从
获取/设置	MSI。CHKCHAR-OPTION	0 1 2 3. 4 5	使用mod 10校验和 使用mod 11校验和(IBM算法) 使用mod 10 mod 10 checksum 使用mod 11 mod 10校验和(IBM算法) 使用mod 11校验和(NCR算法) 使用mod 11 mod 10校验和(NCR算法)	0	X X
获取/设置	MSI。CODESIZE	ON最小最大值 OFF最小最大值	接受任何长度的MSI Plessey。 设置接受的MSI Plessey的最小/最大长度。	N/A	X X
获取/设置	MSI。QZ-SIZE	0 - 100	安静区单一严格大小。	50
获取/设置	MSI。验证	On | off	打开/关闭MSI条形码验证。	在	X
获取/设置	QR。微	On | off	打开/关闭QR微符号	从
获取/设置	的象征。AZTECCODE	On | off	打开/关闭阿兹特克代码符号。	从
获取/设置	的象征。CODABAR	On | off	打开/关闭Codabar符号。	从
获取/设置	的象征。C11	On | off	打开/关闭代码11符号。	从	X
获取/设置	的象征。C128	On | off	打开/关闭代码128符号。	从
获取/设置	的象征。这件	On | off	打开/关闭Code 25符号(标准)。	从
获取/设置	的象征。C39	On | off	打开/关闭Code 39符号。	从
获取/设置	的象征。C93	On | off	打开/关闭代码93符号。	从
获取/设置	的象征。鸡笼	On | off	打开/关闭COOP符号(代码25变体)。	从	X
获取/设置	的象征。DATAMATRIX	On | off	打开/关闭数据矩阵符号。	从
获取/设置	的象征。DATABAR	On | off	打开/关闭DataBar符号。也检查DATABAR:GROUP, DATABAR。有限,DATABAR。扩大to check which subtypes are read if Databar is turned on.	从
获取/设置	的象征。DOTCODE	On | off	打开/关闭DotCode符号。	从
获取/设置	的象征。国际航空运输协会	On | off	打开/关闭IATA符号(代码25变体)。	从	X
获取/设置	的象征。倒	On | off	打开/关闭反转符号(代码25变体)。	从	X
获取/设置	的象征。ITF14	On | off	打开/关闭ITF-14符号(代码25变体)。	从	X
获取/设置	的象征。UPC-EAN	On | off	开启/关闭UPC-A、UPC-E、EAN-8和EAN-13符号。	从
获取/设置	的象征。矩阵	On | off	打开/关闭矩阵符号(代码25变体)。	从	X
获取/设置	的象征。MAXICODE	On | off	打开/关闭MaxiCode符号。	从	X
获取/设置	的象征。MSI	On | off	打开/关闭MSI Plessey符号。	从
获取/设置	的象征。PDF417	On | off	打开/关闭PDF417符号。	从
获取/设置	的象征。地球	On | off	打开/关闭PLANET符号。	从
获取/设置	的象征。POSTNET	On | off	打开/关闭POSTNET符号。	从
获取/设置	SYMBOL.4STATE-IMB	On | off	打开/关闭智能邮件条形码符号。	从
获取/设置	SYMBOL.4STATE-RMC	On | off	打开/关闭皇家邮政编码符号。	从
获取/设置	的象征。QR	On | off	打开/关闭QR和MicroQR符号。	从
获取/设置	TELEPEN。FORCE-NUMERIC	On | off	仅打开/关闭数字Telepen符号的读取。	从	X
获取/设置	TELEPEN。验证	On | off	打开/关闭Telepen条形码验证。	从	X
获取/设置	触发器。类型	0 1 2 3. 4 5	单台(不支持) 表示(不支持) 手册(默认) Burst(不支持) Self(不支持) 连续	2(手动)
获取/设置	UPC-EAN。EAN13	On | off	打开/关闭EAN-13符号。	在	X
获取/设置	UPC-EAN。EAN8	On | off	打开/关闭EAN-8符号。	在	X
获取/设置	UPC-EAN。UPC-A	On | off	打开/关闭UPC-A符号。	在	X
获取/设置	UPC-EAN。UPC-E	On | off	打开/关闭UPC-E符号。	在	X
获取/设置	UPC-EAN。UPCE1	On | off	打开/关闭UPC-E1符号。	从
获取/设置	UPC-EAN。补充	0 - 4	cmbSDK的移动摄像头API只支持打开/关闭UPC/EAN补充代码支持，而DMCC命令允许它们打开/关闭 0:了 1:需要 2:表示输入2位数字 3:需要5位数字，或者 4:有选择地允许他们。 cmbSDK的移动相机API将处理选项1-4相同;简单地启用它们。	0
获取/设置	UPC-EAN。验证	On | off	打开/关闭UPC条形码验证。	从	X
获取/设置	振动。好	On | off	设置/获取读取代码时是否震动(默认为ON)	N/A