用于Android的Cognex移动条码SDK

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

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

CMBSDK使用移动设备的内置摄像机使用默认的条形码读取选项。但是，CMBSDK不会为相机阅读器实现保存的配置。这意味着每次应用程序开始使用相机阅读器时，它就以摄像机的默认设置开始。有关默认设置的列表，请参阅附录．

在没有硬件触发的情况下，移动设备必须使用替代方法来启动条形码扫描。cmbSDK支持三种触发条形码扫描的方法:

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

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

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

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

横向或纵向	仅限肖像	仅风景
大多数条形码可以在纵向或横向扫描。	大多数定义良好、大小适中的条形码都可以在纵向扫描，这是手持移动设备最自然的方式。 例如:QR, Data Matrix, Maxicode。	长、密或形状不好的条形码更容易在横向扫描，横向扫描的分辨率更高。 示例：PDF417。

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

要优化应用程序，请执行以下操作：

• 仅对应用程序需要扫描的条码类型启用解码。cmbSDK支持几乎40种不同的条码类型和子类型的解码，导致所有结果都是低性能和意外错误。
• 请勿同时启用某些符号系统和/或高级功能。
• 优化你的相机分辨率。默认情况下，cmbSDK使用高清图像进行条码解码。
• 使用适当的解码器工作水平。cmbSDK有一个可配置的工作级别，控制它执行图像分析的积极性。cmbSDK使用默认值(级别2)，这对于大多数条形码来说已经足够了。使用更高级别的代码可以更好地解码质量较差的条形码，从而降低性能。

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

安装Android cmbSDK

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

   2. 在Source directory字段中，浏览包含build.gradle文件和cmbsdklib-release.aar文件的cmbsdklib发布目录。在模块名称字段中，您应该看到: cmbsdklib-release,并点击完成．

   
   -如果你使用的是旧版本的Android Studio，你可以直接导入。aar文件:
   1. 右击你的app模块，选择新增>模块> Import . jar /。AAR包,然后单击下一个．

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

3. 新模块可用后，右键单击app模块，选择打开模块设置，并选择依赖关系选项卡。

   

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

6. 从中安装MX Connect应用程序应用商店与MX移动终端通信。

安装iOS cmbSDK：

1. 安装最新的面向iOS开发的XCode．
2. 下载Cognex Mobile Barcode SDK for iOS．

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

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

安卓：

1. 获取许可证密钥后，在应用程序的AndroidManifest.xml文件中的应用程序标记下添加以下行：

   <元数据android: name = " MX_MOBILE_LICENSE " android: value = " YOUR_MX_MOBILE_LICENSE " / >

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

     <类别android: name = " android.intent.category.LAUNCHER " / > < /意图过滤器> < /活动> <元数据android: name = " MX_MOBILE_LICENSE " android: value = " g / 9 ytjzcja + sxt4DTEDxR4hp6sZh9bmL97vUx + EE9uY = " / > < /应用程序>

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

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

iOS:

获得许可密钥后，将其作为字符串添加到应用程序的Info中。Plist文件下的密钥MX_MOBILE_LICENSE．

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

2. 安装cmbSDK你的项目。

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

4. 删除:
   • 全部的DataManSystem.createDataManSystemOverUsb ()方法。
   • 全部的DataManSystem.createDataManSystemOverUsbAccessory ()方法。
   • USB_ DEVICE-ALTEAD和USB_ACCESSORY_ATTACHED INTINT过滤器和来自androidmanifest.xml文件的元数据。
   • USB和附件描述符xml文件从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包中找到)使用的是全屏预览。要将示例应用程序更改为使用局部视图，请添加以下内容相对在结束时约束青年在Activity_scanner.xml.文件。使用这个布局广告ViewGroup读取器构造函数中的参数(getPhoneCameraDevice)当读取器设备初始化．

• 要显示最后扫描的图像，使用图片框需要容器。
• 要将扫描结果显示为文本，请使用文本框是必要的。

3. 设置以下接口以监视读卡器的连接状态并接收有关读取代码的信息：

   公共类scaneractivity扩展AppCompatActivity实现OnConnectionCompletedListener, ReaderDeviceListener, ActivityCompat。OnRequestPermissionsResultCallback{…@Override public void onConnectionCompleted(ReaderDevice ReaderDevice, Throwable error){//如果我们有有效的连接错误参数，将为空，/ /否则就是错误,告知我们问题时,我们已经连接到读者设备如果(错误! = null){/ /要求相机允许如果必要(错误instanceof CameraPermissionException) ActivityCompat.requestPermissions (((ScannerActivity)), [] {Manifest.permission新字符串。相机},REQUEST_PERMISSION_CODE);updateUIByConnectionState ();}} //当与self连接时调用。readerDevice已更改。// readerDevice仅在ConnectionState中可用。connect " state @Override public void onConnectionStateChanged(ReaderDevice reader) {clearResult();如果(reader.getConnectionState() == ConnectionState.Connected);} 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读卡器的读卡器设备对象：

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

MX移动终端的可用性可以在设备打开或关闭时更改，或者如果USB电缆连接或断开连接。您可以使用以下内容处理这些更改ReaderDeviceListener接口方法:

public void onAvailabilityChanged(ReaderDevice reader);

建议您使用MX Mobile终端来扫描条形码。但是，CMBSDK还支持使用移动设备的内置摄像机。这包括支持可选的外部瞄准器或照明，以及Live-Stream Preview的定制。

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

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

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

的CameraMode参数的类型为CameraModeCameraMode.java它接受下表中列出的值之一。

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

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

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

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

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

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

的ViewGroup(可选)参数指定实时流预览的容器。如果不设置该参数零，使用全屏预览。

的RegistrationKey(可选)参数用于使用您拥有的许可证密钥对SDK进行许可

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

例子

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

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

这将在扫描仪暂停时启动预览，并使用软触发按钮切换扫描。按下软触发按钮后，预期的预览外观如下：

由于设置了活动符号，图像中的取景器具有活动扫描表面。有关详细信息，请参见启用符号赛．

在Android 6.0及以上版本中，您需要请求用户的许可才能访问移动设备的内置摄像头。

如果摄像机由于权限问题无法打开，则onConnectionCompleted (readerDevice错误)回调包含A.CameraPermissionException在错误参数中。属性可以检查此异常类型运算符操作员和请求活动中的权限。

如果(错误instanceof CameraPermissionException) ActivityCompat.requestPermissions(((ScannerActivity) this)， new String[]{Manifest.permission. permission. permission. permission. permission。相机},REQUEST_PERMISSION_CODE);

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

@Override public void onRequestPermissionsResult(int requestCode， @NonNull String[] permissions， @NonNull int[] grantResults){//检查权限请求的结果。如果用户允许，则连接到readerDevice。长度> 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {if (readerDevice != null && readerDevice. getconnectionstate () != ConnectionState.Connected) readerDevice.connect(ScannerActivity.this);} else {if (ActivityCompat.shouldShowRequestPermissionRationale(((ScannerActivity) this)， Manifest.permission.CAMERA)) {AlertDialog。Builder构建器= new AlertDialog.Builder(这).setMessage(“你需要允许访问相机”).setPositiveButton(“OK”,新DialogInterface.OnClickListener () {@Override公共空onClick (DialogInterface DialogInterface, int i) {ActivityCompat.requestPermissions (ScannerActivity。这样,新String [] {Manifest.permission。相机},REQUEST_PERMISSION_CODE);}}) .setNegativeButton("取消"，null);AlertDialog = builder.create();dialog.show ();} } } }

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

readerDevice.setReaderDeviceListener(这个);

具体操作请参见步骤3为Android设置您的应用程序才能使用CoGnex Mobile Barcode SDK．

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

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

初始化后调用Connect方法ReaderDevice以及设置侦听器方法来处理来自读取器的响应。connect方法接受OnConnectionCompletedListener参数:

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

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

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

的onConnectionCompleted当连接过程完成时，还会调用作为连接参数传递的方法。如果存在连接错误，则此方法提供了一个Throwable对象

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

您可以通过调用正确配置的读取器来开始扫描条形码startScanning方法从你ReaderDevice类:

readerDevice.startScanning ();

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

您可以使用以下内容停止扫描：

ReaderDevice.Stopscanning（）;

在下列情况之一下，扫描停止：

• 阅读器找到并解码了条形码。
• 您释放了触发器或按下了直播预览屏幕上的停止按钮。
• 相机读者超时而不找到条形码。
• 应用程序调用stopScanning ()方法。

属性中的ReadResults可迭代结果集合对象，当成功解码条形码时ReaderDevice侦听器方法。的onReadResultReceived调用侦听器方法，因为读取器解码了条形码或扫描过程完成。

例子

//扫描完成后，通过检测条形码、使用屏幕按钮或硬件触发按钮取消扫描，或者如果扫描超时@Override public void onReadResultReceived（ReaderDevice ReaderDevice，ReadResults results）{clearResult（）；if（results.getSubResults（））！=null&&results.getSubResults（）.size（）>0{for（ReadResult subResult:results.getSubResults（））{createResultItem（subResult）；}否则如果（results.getCount（）>0）{createResultItem（results.getresulttat（0））；}isScanning=false；btnScan.setText（“开始扫描”）；resultListAdapter.notifyDataSetChanged（）；}

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

可以使用以下方法启用单个符号：ReaderDevice类:

readerDevice.setSymbologyEnabled(symbologylistener) . readerDevice.setSymbologyEnabled(symbologylistener) . readerDevice.setSymbologyEnabled(symbologylistener) . readerDevice.setSymbologyEnabled(symbologylistener) . readerDevice.setSymbologyEnabled(symbologylistener)。DATAMATRIX,真的,null);readerDevice.setSymbologyEnabled(象征。UPC_EAN,真的,null);

该方法中用于符号参数的所有符号均可在ReaderDevice.java．

例子

/*启用QR扫描*/readerDevice.setSymbologyEnabled（Symbology.QR，true，null）；

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

/ *禁用代码25扫描*/ readerDevice.setSymbologyEnabled(symbol。这件、虚假、无效);

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

@Override公共空onSymbologyEnabled (ReaderDevice读者,象征符号,布尔启用,可抛出错误){如果(错误! = null){/ *可能不成功的象征是由当前不支持的设备,或者有问题ReaderDevice和MX设备之间的连接* /}其他{/ /成功}}

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

readerDevice。setLightsOn(true, null);

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

公共类scaneractivity扩展AppCompatActivity实现....OnLightsListener……{…@Override public void onLightsOnCompleted(ReaderDevice reader, Boolean on, Throwable error) {if (error != null) {// Unsuccessful} else {// Success}}}

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

• 正常：未缩放（100%）
• 1级缩放（Android上默认为150%）
• 2级缩放(Android默认300%)

的设置相机。变焦-PERCENT [100-MAX] [100-MAX]命令，用于配置两个级别的放大百分比。100不被放大，MAX(上升到1000)在设备能够的范围内放大。第一个参数用于设置级别1的缩放，第二个参数用于设置级别2的缩放。

控件可以检查当前的缩放设置获取Camera.zoom-percep命令，返回两个值:级别1和级别2缩放。

例子

readerDevice.getDataManSystem()。sendCommand(“设置相机。ZOOM-PERCENT 250 500”);

获取/设置相机。变焦0 - 2是另一个用于设置缩放级别或返回实际设置的命令。SET命令可能的取值有:

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

您可以在扫描期间甚至甚至在扫描期间调用此命令，并且缩放达到配置级别。如果扫描完成，则将值重置为正常行为（0）。

例子

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

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

使用cmbSDK 2.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;

Cognex扫描设备通过DMCC (DataMan Control Commands)对设备进行配置和控制。设备的每个功能都可以使用这种基于文本的语言进行控制。API提供了一种向设备发送DMCC命令的方法。存在用于设置和查询配置属性的命令。

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

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

例子

//将扫描方向改为omnidirectional readerDevice.getDataManSystem()。sendCommand("SET DECODER.1D-SYMBOLORIENTATION 0"， ScannerActivity.this);//修改实时流预览的扫描超时为10秒readerDevice.getDataManSystem()。sendCommand(“设置解码器。MAX-SCAN-TIMEOUT 10”,ScannerActivity.this);

您还可以调用DMCC查询命令并在onreponsereceivedListener.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 Mobile终端。如果重新启动，它具有保存的配置状态。

控件可以监视此异步方法的完成情况OnResetConfigListenerInterface，可选参数。

public class ScannerActivity extends Activity implements ....OnResetConfigListener……{…@Override public void onResetConfigCompleted(ReaderDevice reader, Throwable error) {if (error != null){//不成功}else{//成功}}

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

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

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

当扫描结束而没有成功读取时，aReadResult返回古德雷德属性设置为false。

启用要在中填充的图像和imageGraphics属性的步骤ReadResult对象，设置相应的enableImage ()和/或enerialImageGraphics（）的属性ReaderDevice对象

要访问扫描条形码中的原始字节，可以使用XML属性。这些字节以Base64字符串的形式存储在"full_string"标签下。该示例展示了如何使用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 . 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结果，请调用enerialImageGraphics（）方法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-正常（未缩放）、1-级别1的缩放、2-级别2的缩放。此缩放级别在扫描期间使用。扫描结束时，将重置为0。	N/A	x
获取/设置	相机。变焦-PERCENT	[100 - max] [100 - max)	设置/返回1级缩放(Android默认150%，iOS默认200%)和2级缩放(Android默认300%，iOS默认400%)。 注意：需要从SDK启动相机至少一次从SDK开始对最大的缩放（MAX）具有适当的值	N/A	x
获取/设置	密码大小	在最小最大 从最小最大	接受任何长度的Codabar。 设置可接受Codabar的最小/最大长度。	N/A	X X
获取/设置	CODABAR。QZ-SIZE	0 - 100	静区尺寸单一严格。	50
获取/设置	CODABAR。验证	|关闭	打开/关闭Codabar条形码验证。	在…上	X
获取/设置	C11。CHKCHAR	|关闭	打开/关闭代码11检查数字。	关	X
获取/设置	C11.CHKCHAR-OPTION	１ ２	需要单独的校验和。需要校验和的两倍。	1	X X
获取/设置	C11。CODESIZE	在最小最大 从最小最大	接受任何长度的代码11。 设置代码11接受的最小/最大长度。	N/A	X X
获取/设置	C11.QZ尺寸	0 - 100	静区尺寸单一严格。	50
获取/设置	C11。验证	|关闭	打开/关闭代码11条形码的验证。	在…上	X
获取/设置	C128。QZ-SIZE	0 - 100	静区尺寸单一严格。	50
获取/设置	C128。验证	|关闭	打开/关闭128码条形码验证。	在…上	X
获取/设置	这件。CODESIZE	在最小最大 从最小最大	接受任意长度的代码25。 设置接受代码25的最小/最大长度。	N/A	X X
获取/设置	这件。QZ-SIZE	0 - 100	静区尺寸单一严格。注意,这件。QZ-SIZE和I2O5。QZ-SIZE是相同的摄像头API设置。	50
获取/设置	这件。验证	|关闭	打开/关闭码25和交错码2的验证。	在…上	X
获取/设置	C39。美国信息交换标准代码	|关闭	打开/关闭码39扩展ASCII码。	关
获取/设置	C39。CODESIZE	在最小最大 从最小最大	接受任何长度的代码39。 设置接受代码39的最小/最大长度。	N/A
获取/设置	C39。CHKCHAR	|关闭	打开/关闭代码39检查数字	关
获取/设置	C39。QZ-SIZE	0 - 100	静区尺寸单一严格。	50
获取/设置	C39。验证	|关闭	打开/关闭39码条形码验证。	在…上	X
获取/设置	C93。美国信息交换标准代码	|关闭	打开/关闭Code 93扩展ASCII码	关	X
获取/设置	C93。CODESIZE	在最小最大 从最小最大	接受任何长度的代码93。 设置代码93接受的最小/最大长度。	N/A
获取/设置	C93。验证	|关闭	打开/关闭代码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为OFF或进入休眠模式时，设备唤醒时，将恢复上次保存的配置。	N/A
	配置。恢复		从非易失性内存中还原保存的配置(仅MX-1xxx)。	N/A
获取/设置	数据。结果类型	0 1 2 4 8	指定要返回的结果(多个值的sum): 0 -没有 1 -文本字符串结果(默认) 2 - XML结果 4 - XML统计数据 8 -扫描图像(参见图像。*命令)	1
获取/设置	DataBar.Expanded.	|关闭	打开/关闭DataBar扩展符号。	关
获取/设置	DATABAR。有限的	|关闭	打开/关闭DataBar Limited符号。	在…上
获取/设置	DATABAR。集团 DATABAR。RSS14	|关闭	打开/关闭DataBar GROUP(在cmbSDK 2.4.1之前称为RSS14)符号。	在…上	X
获取/设置	databar.rss14stack.	|关闭	打开/关闭DataBar RSS14堆叠符号。从cmbSDK v2.4.1中已弃用，请使用DATABAR。集团。	关	X
获取/设置	DATABAR。验证	在…上	打开/关闭Databar条形码验证。	在…上	X
获取/设置	解码器1.1D-符号方向	0 1 2 3.	使用全向扫描方向。 使用水平和垂直扫描方向。 使用垂直扫描方向。 使用水平扫描方向。	1
获取/设置	译码器。努力	1 - 5	设置图像分析/解码的努力水平。缺省值是2。不要使用4-5进行在线扫描。	2	X
获取/设置	译码器。MAX-SCAN——超时	0-120	设置实时流预览的超时时间。当达到超时时，解码将暂停;直播预览将保留在屏幕上。	60	X
得到	最大线程数		返回设备支持的最大CPU线程数。	N/A	X
获取/设置	译码器。线色	(0-MAX)	指定扫描程序在扫描过程中可以使用的最大CPU线程数。	N/A	X
	设备。默认的		将设备（包括摄像机API）设置重置为默认值（参见附录B）。	N/A
得到	设备。FIRMWARE-VER		获取设备固件版本。	N/A
得到	设备。ID		返回由Cognex分配给扫描设备的设备ID。 对于内置相机，SDK返回53。	N/A
获取/设置	设备。的名字		返回分配给设备的名称。默认情况下，这是“MX-”加上DEVICE.SERIAL-NUMBER的最后6位数字。	“MX-”+ DEVICE的后六位。序列号
得到	设备。串行-数		返回设备的序列号。对于内置摄像头，SDK会分配一个伪随机数。	N/A
得到	设备类型		返回由Cognex分配给扫描设备的设备名称。对于内置摄像头，SDK返回“MX-Mobile”。	N/A
获取/设置	的焦点。FOCUSTIME	0-10	设置相机的自动对焦周期(相机应该尝试重新对焦的频率)。	3.
获取/设置	I2O5。CHKCHAR	|关闭	打开/关闭交错2的5个校验位。	关
获取/设置	I2O5。CODESIZE	在最小最大 从最小最大	接受任何长度交错2的5。 设置最小/最大长度的接受交叉2的5。	N/A	X X
获取/设置	I2O5。QZ-SIZE	0 - 100	静区尺寸单一严格。注意,这件。QZ-SIZE和I2O5。QZ-SIZE是相同的摄像头API设置。	50	X
获取/设置	I2O5。验证	|关闭	转动验证的5个中的验证，以及Code 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：PassiveAmer和Activeaimer
获取/设置	light.aimer-timeout.	0 - 600	艾默秒内暂停。	N/A
获取/设置	光。内部,使	|关闭	启用/禁用照明(当扫描仪启动时)。	关
获取/设置	msi.chkchar.	|关闭	打开/关闭MSI Plessey检查数字。	关
获取/设置	msi.chkchar.-OPTION	0 1 2 3. 4 5	使用mod 10校验和 使用mod 11校验和(IBM算法) 使用mod 10 mod 10校验和 使用mod 11 mod 10校验和(IBM算法) 使用mod 11校验和(NCR算法) 使用mod 11 mod 10校验和(NCR算法)	0	X X
获取/设置	MSI。CODESIZE	在最小最大 从最小最大	接受任何长度的MSI Plessey。 设置可接受MSI Plessey的最小/最大长度。	N/A	X X
获取/设置	MSI。QZ-SIZE	0 - 100	静区尺寸单一严格。	50
获取/设置	MSI。验证	|关闭	打开/关闭MSI条形码验证。	在…上	X
获取/设置	QR。微	|关闭	打开/关闭QR Micro Symbology	关
获取/设置	的象征。AZTECCODE	|关闭	打开/关闭阿兹特克代码符号。	关
获取/设置	symbol.codabar.	|关闭	打开/关闭Codabar符号。	关
获取/设置	的象征。C11	|关闭	打开/关闭代码11符号系统。	关	X
获取/设置	的象征。C128	|关闭	打开/关闭代码128符号。	关
获取/设置	的象征。这件	|关闭	打开/关闭代码25符号(标准)。	关
获取/设置	的象征。C39	|关闭	打开/关闭代码39符号。	关
获取/设置	的象征。C93	|关闭	打开/关闭代码93符号。	关
获取/设置	的象征。鸡笼	|关闭	打开/关闭COOP符号(代码25变体)。	关	X
获取/设置	的象征。DATAMATRIX	|关闭	打开/关闭数据矩阵符号。	关
获取/设置	的象征。DATABAR	|关闭	打开/关闭DataBar符号。也检查DATABAR:GROUP, DATABAR。有限,DATABAR。展开以检查在Databar打开时读取哪些子类型。	关
获取/设置	的象征。DOTCODE	|关闭	打开/关闭DotCode符号。	关
获取/设置	的象征。国际航空运输协会	|关闭	打开/关闭IATA符号(代码25变体)。	关	X
获取/设置	符号。inverted.	|关闭	打开/关闭反转符号（代码25变体）。	关	X
获取/设置	的象征。ITF14	|关闭	打开/关闭ITF-14符号(代码25变体)。	关	X
获取/设置	的象征。UPC-EAN	|关闭	打开/关闭UPC-A、UPC-E、EAN-8和EAN-13符号。	关
获取/设置	符号矩阵	|关闭	打开/关闭矩阵符号（代码25变体）。	关	X
获取/设置	的象征。MAXICODE	|关闭	打开/关闭MaxiCode符号。	关	X
获取/设置	的象征。MSI	|关闭	打开/关闭MSI Plessey符号。	关
获取/设置	的象征。PDF417	|关闭	打开/关闭PDF417符号。	关
获取/设置	的象征。地球	|关闭	打开/关闭行星符号。	关
获取/设置	的象征。POSTNET	|关闭	打开/关闭POSTNET符号。	关
获取/设置	SYMBOL.4STATE-IMB	|关闭	开启/关闭智能邮件条码符号。	关
获取/设置	SYMBOL.4STATE-RMC	|关闭	打开/关闭皇家邮政编码符号。	关
获取/设置	的象征。QR	|关闭	打开/关闭QR和MicroQR符号。	关
获取/设置	telepen.force-numeric.	|关闭	开启/关闭数字电话笔符号的读取。	关	X
获取/设置	TELEPEN。验证	|关闭	打开/关闭Telepen条形码的验证。	关	X
获取/设置	触发器。类型	0 1 2 3. 4 5	单(不支持) 演讲(不支持) 手册(默认) 破裂(不支持) 自我(不支持) 连续	2(手动)
获取/设置	UPC-EAN。EAN13	|关闭	打开/关闭EAN-13符号。	在…上	X
获取/设置	UPC-EAN.EAN8.	|关闭	打开/关闭EAN-8符号系统。	在…上	X
获取/设置	UPC-EAN.UPC-A	|关闭	打开/关闭UPC-A Symbology。	在…上	X
获取/设置	UPC-EAN.UPC-E	|关闭	打开/关闭UPC-E符号。	在…上	X
获取/设置	UPC-EAN。UPCE1	|关闭	开启/关闭UPC-E1符号。	关
获取/设置	UPC-EAN。补充	0 1 2 3. 4	关闭UPC补充代码(忽略) 打开UPC补充代码(必需) 要求2位补充。 要求5位补充。 不是必需的。	0
获取/设置	UPC-EAN。验证	|关闭	打开/关闭UPC条形码验证。	关	X
获取/设置	振动。好	|关闭	设置/获取是否在读取代码时振动(默认为ON)	N/A