康耐视移动条码SDK for iOS

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

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

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

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

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

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

此外，CmbSDK支持一个主动瞄准器，它有自己的内置led照明和瞄准:MX-100条形码阅读器。MX-100是iOS智能手机的移动设备配件，通过移动设备外壳连接到移动设备上。MX-100内置的LED投影出一个绿色的点，以帮助读取条形码。

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

为了获得更好的读取性能，在纵向上读取QR、Data Matrix和Maxicode，在横向上读取PDF417这样的长代码。

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

优化应用程序:

• 仅对应用程序需要扫描的条形码类型启用解码。

• 不要同时启用某些符号和/或高级功能。PDF417, DataMatrix和Dotcode是对CPU要求最高的代码，启用了先进的功能，可以降低解码时间。
• 优化相机分辨率。cmbSDK默认使用高清图像进行条码解码。
• 使用适当的解码器努力级别。cmbSDK具有可配置的努力级别，以控制它执行图像分析的积极程度。cmbSDK使用默认值(级别2)，这对大多数条形码来说是足够的。使用更高的级别可以对质量较差的条形码进行更好的解码，从而导致性能变慢。

设置你的应用程序使用iOS cmbSDK:

1. 打开XCode，开始一个新项目。

2. 添加以下库和框架到您的项目:

   * SystemConfiguration.framework * AVFoundation.framework * CoreGraphics.framework * CoreMedia.framework * CoreVideo.framework * MediaPlayer.framework * Security.framework * AudioToolbox.framework * cmbSDK.framework

3. 去你的项目Info.plist文件并添加隐私-摄像头使用说明或NSCameraUsageDescription显示一条关于应用程序如何使用用户移动设备的摄像头的消息。

4. 如果您正在使用MX移动终端的cmbSDK，还需要添加支持的外部附属协议或UISupportedExternalAccessoryProtocols来com.cognex.dmcc在项目的Info.plist．(在这种情况下，你必须在苹果应用商店发布应用之前创建MFi请求。你可以阅读更多的细节让MX移动终端应用进入应用商店部分。)

cmbSDK旨在为支持的扫描设备提供高级抽象接口。这不仅包括MX系列移动终端，还包括打算使用移动设备相机作为成像设备的应用程序。与这些设备通信和管理的复杂性被封装在SDK本身中:让应用程序连接到所选择的设备，然后使用它。

应用程序和受支持的条形码扫描设备之间的主要接口是CMBReaderDevice类。该类代表设备本身的抽象层，处理所有通信以及任何必要的硬件管理(例如，智能手机扫描)。

cmbSDK的使用方法如下:

1. 为要使用的设备类型初始化一个读取设备:MX读取器或相机读取器。

2. 连接阅读器设备。

3. 配置读取器(如果需要)。

4. 开始扫描。

初始化、连接和配置通常只需要在应用程序中执行一次，除了以下情况:

• MX阅读器可能会断开连接(停止使用超时，电池没电等)。已经提供了一个方法来处理这种情况，并将在后面的部分中讨论。
• 您的应用程序被设计为允许用户更改设备。的cmbSDK is explicitly designed to support this: your application simply disconnects from the current device and establishes a new connection to a different device. The sample application has been written to explicitly demonstrate this capability, which you get when downloading the CmbSDK.

初始化CMBReaderDevice使用MX移动终端，如MX-1000, MX-1100，或MX-1502是很容易的:简单地使用MX设备方法创建阅读器设备(不需要参数)，并设置适当的委托(通常是self):

让readerDevice:CMBReaderDevice = CMBReaderDevice. readerofmx () readerDevice.delegate = self

CMBReaderDevice *readerDevice = [CMBReaderDevice readerOfMXDevice];readerDevice.delegate = self;

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

func availabilityDidChange(ofReader reader: CMBReaderDevice)

- (void)availabilityDidChangeOfReader:(CMBReaderDevice *)reader

使用其他康耐视网络设备

如果你想连接到网络上的康耐视设备(例如手持或固定安装)，你必须使用另一个名为NetworkDiscovery．这个框架可以在cmbSDK包中找到。

使用移动设备的内置摄像头进行条形码扫描可能比使用MX移动终端更复杂。因此cmbSDK支持多种配置，以提供最大的灵活性，包括支持可选的外部瞄准镜和照明，以及自定义直播流预览外观的能力。MX-100是iPhone的外部设备，我们称之为主动瞄准器。

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

* CDMCameraMode * CDMPreviewOption * UIView

的CameraMode参数的类型CDMCameraMode(定义在CDMDataManSystem.h)，并接受以下值之一:

• kCDMCameraModeNoAimer:在没有瞄准附件的情况下，该模式会初始化屏幕上的直播预览，帮助条形码在视场中定位，进行检测解码。
• kCDMCameraModePassiveAimer:初始化被动瞄准器的使用，这是一个外部配件，使用设备内置的LED闪光灯照明，以投射瞄准模式。在这种模式下，屏幕上不会显示直播预览。
• kCDMCameraModeActiveAimer:初始化主动瞄准器的使用，如MX-100。这样的附件有内置led投影瞄准模式和照明由内置电池供电。在这种模式下，屏幕上不会显示直播预览。
• kCDMCameraModeFrontCamera:初始化前置摄像头的使用。在这种模式下，照明是不可用的。

上述模式为作为代码阅读器的移动设备提供了以下默认设置:

• 模拟硬件触发器被禁用。
• 当startScanning ()，则开始解码过程。(寻求CDMPreviewOptionPaused有关详情)。

根据所选择的模式，将设置以下附加选项和行为:

• kCDMCameraModeNoAimer(NoAimer)
  • 时，显示直播预览startScanning ()方法。
  • 照明和控制按钮是可用的和可见的直播流预览。
  • 瞄准器控制命令被忽略。

• kCDMCameraModePassiveAimer(PassiveAimer)
  • 时，直播预览将不会显示startScanning ()方法默认调用。
  • 没有照明
  • 照明控制命令被忽略。

• kCDMCameraModeActiveAimer(mx - 100)
  • 时，直播预览将不会显示startScanning ()方法默认调用。
  • 照明是可用的，如果一个预览选项相机预览启用，照明控制按钮也是可用的。
  • 接受照明或瞄准器控制命令。

• kCDMCameraModeFrontCamera(FrontCamera)
  • 时，显示直播预览startScanning ()方法。
  • 使用前置摄像头。
  • 照明和控制按钮不可用。
  • 照明或瞄准器控制命令被忽略。

的previewOptions参数(类型)CDMPreviewOption，定义为CDMDataManSystem.h)用于更改读取器的默认值或覆盖从选定对象派生的默认值CameraMode．在传递参数时，可以通过OR-ing指定多个选项。可用的选项如下:

• kCDMPreviewOptionDefaults参数设置的所有默认值CameraMode．
• kCDMPreviewOptionNoZoomBtn:隐藏直播预览上的缩放按钮。
• kCDMPreviewOptionNoIllumBtn:隐藏直播预览中的照明按钮。
• kCDMPreviewOptionHwTrigger:启用模拟硬件触发(音量控制)开始扫描。按下后，开始扫描。
• kCDMPreviewOptionPaused:显示实时预览startScanning ()方法在不开始解码(即查找条形码)的情况下被调用。按屏幕扫描按钮开始解码。
• kCDMPreviewOptionAlwaysShow:当选择主动或被动瞄准模式时，实况预览的强制显示(例如:CameraMode == kCDMCameraModePassiveAimer）
• kCDMPreviewOptionPessimisticCaching:仅在以下情况下使用CameraMode == kCDMCameraModeActiveAimer，这将读取设置ActiveAimer当应用程序从后台恢复时，以防瞄准器设置从另一个应用程序更改。

• kCDMPreviewOptionHighResolution:使用分辨率较高的设备摄像头帮助扫描小条码，但解码时间较慢。该选项在支持该选项的设备上将分辨率设置为1920x1080，在不支持该选项的设备上将分辨率设置为默认值。默认分辨率为1280x720。

• kCDMPreviewOptionHighFrameRate:将相机设置为60 FPS，而不是默认的30 FPS，以提供更流畅的相机预览。

例子:

创建一个没有瞄准器和全屏直播预览的阅读器:

let readerDevice:CMBReaderDevice = CMBReaderDevice。readerOfDeviceCamera (: CDMCameraMode。noAimer previewOptions: CDMPreviewOption。init(rawValue: 0)， previewView:nil) readerDevice.delegate = self

CMBReaderDevice *readerDevice = [CMBReaderDevice readerOfDeviceCameraWithCameraMode:kCDMCameraModeNoAimer previewOptions:kCDMPreviewOptionDefaults previewView:nil];readerDevice.delegate = self;

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

let readerDevice:CMBReaderDevice = CMBReaderDevice。readerOfDeviceCamera (: CDMCameraMode。noAimer previewOptions: [CDMPreviewOption。noZoomBtn CDMPreviewOption。hwTrigger]， previewView:nil) readerDevice.delegate = self

CMBReaderDevice *readerDevice = [CMBReaderDevice readerOfDeviceCameraWithCameraMode:kCDMCameraModeNoAimer previewOptions:(kCDMPreviewOptionNoZoomBtn | kCDMPreviewOptionHwTrigger) previewView:nil];readerDevice.delegate = self;

初始化CMBReaderDevice并设置一个委托来处理来自阅读器的响应。

然后使用connectWithCompletion：

//如果self.readerDevice.availability == CMBReaderAvailibilityAvailable{//在readerDevice对象和设备self.readerDevice. available之间创建连接，则确保设备已经打开并准备就绪。连接(完成:{(错误:错误?)在if错误!= nil{//处理连接错误}})}

//如果(readerDevice.)可用性== CMBReaderAvailibilityAvailable){//创建readerDevice对象和设备之间的连接[readerDevice connectWithCompletion:^(NSError *error) {if (error){//处理连接错误}}];｝

当连接connectionStateDidChangeOfReader在委托中调用，您可以在阅读器设备中检查连接状态connectionState参数。应该是这样CMBConnectionStateConnected，这表示您已成功连接到CMBReaderDevice，可以开始使用康耐视移动条码SDK。

为了在连接到设备后更改一些设置，cmbSDK提供了一组高级的、与设备无关的api，用于设置和检索设备的当前配置。

使用MX阅读器和相机阅读器进行扫描的区别将在以下部分详细说明。

MX系列移动终端提供了复杂的设备配置和管理，包括保存在设备上的配置。MX设备是康耐视预先配置的，大多数符号和功能都可以使用。

如果您想要自定义配置，请通过DataMan安装工具或Cognex快速安装重新配置。这两种工具都可以轻松地将保存的配置分发到多个设备，以便进行简单的配置管理。

移动应用程序能够配置MX设备，让您选择:

• 有多个扫描应用程序，每一个都需要不同的设备设置集
• 在“已知”状态下创建自己的选项，即使设备已正确预配置

cmbSDK使用一组默认选项用于移动设备的内置摄像头读取条形码。然而，有两个重要的区别需要记住:

• cmbSDK不实现内置摄像头读取器的已保存配置。每次应用程序使用相机阅读器启动默认自动使用。
• cmbSDK默认情况下不启用符号。应用程序程序员允许在应用程序中扫描所有条形码符号。作为只显式启用所需符号的必要条件，应用程序在移动设备上实现了最优的扫描性能。

MX-100是一款仅适用于iphone的设备外壳附件，为内置摄像头提供了额外的功能，如瞄准功能和更好的照明控制。作为MX设备和内置扫描仪的混合，MX-100具有存储在设备上的瞄准器强度、照明强度和瞄准器调制的设置，而其余的设置，如符号设置，存储在cmbSDK中。看到MX-100用户指南获取更多信息。

以下是使用MX-100设备时要记住的一些事情:

• MX-100不需要许可证才能使用设备摄像头，可选择生成一个免费许可证用于跟踪目的。
• MX-100是预先配置的，cmbSDK默认启用以下符号:
  • 39码
  • 代码128
  • Databar
  • PDF417
  • QR
  • UPC / EAN
• cmbSDK扩展了缓存机制，以加强与MX-100的光通信。缓存存储了所有的MX-100设置，并且在cmbSDK中是透明的。缓存的初始化和更新是cmbSDK的责任。不同的设置有不同的缓存:
  • 持久缓存:设置/值很少改变(如果有的话)和SDK可以在iPhone上缓存一段时间。这些项是MX-100序列号、型号和固件版本。持久缓存每7天更新一次。
  • 会话缓存:当应用程序使用MX-100时可能会改变的设置/值(不太可能)，但应该在SDK加载/初始连接到MX-100时从MX-100读取。这些项目是:瞄准强度，瞄准调制，瞄准超时，照明强度和照明状态。
    默认情况下，会话缓存将乐观地维护以获得最佳性能。SDK假设其他应用程序没有改变瞄准器的设置，SDK只需要在初始连接建立时读取一次瞄准器的设置。

控件的以下方法可以启用单个符号CMBReaderDevice对象:

-(void) setSymbology:(CMBSymbology) symbolology enabled:(bool)enabled completion:(void (^)(NSError *error))completionBlock;

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

例子

self.readerDevice。setsymbsymbologyqr (CMBSymbologyQR, enabled: true, completion: {(_ error: error ?) -> Void in if error != nil{//启用该符号失败，可能原因是:阅读器断开，电池或电缆未插，或当前阅读器设备不支持符号}})

[readerDevice setsymbsymbologyqr enabled:YES completion:^(NSError *error){if (error){//启用该符号失败，可能原因为:reader断开连接，电池或电缆未插拔，或当前readerDevice不支持符号}}];

同样的方法也可以用来关闭符号:

self.readerDevice。setsymbsymbologyupcean (CMBSymbologyUpcEan, enabled: false, completion: {(_ error: error ?) -> Void in if error != nil{//启用该符号失败，可能原因为:阅读器未连接，电池或电缆未插拔，或当前阅读器设备不支持符号}})

[readerDevice setsymbsymbologyupcean enabled:NO completion:^(NSError *error){if (error){//启用该符号失败，可能原因为:reader断开连接，电池或电缆未插拔，或当前readerDevice不支持符号}}];

如果您的阅读器设备配备了照明(例如led)，您可以使用以下方法在扫描开始时控制它们是打开还是关闭CMBReaderDevice对象:

self.readerDevice.setLightsON(true){(错误:错误?)in if error != nil{//启动照明失败，可能原因是:阅读器断开，电池或电缆未插电，或设备没有照明灯}}

[readerDevice setLightsON:YES completion:^(NSError *error) {if (error){//开启照明失败，可能原因是:阅读器断开，电池没电或电缆未插电，或设备没有照明灯}}];

请记住，并非cmbSDK支持的所有设备和设备模式都允许照明控制。例如，如果使用内置相机在被动瞄准模式，照明是不可用的，因为LED是用于瞄准。

如果内置摄像头用作阅读器设备，您可以配置缩放级别并定义使用这些缩放级别的方式。

手机摄像头有3个缩放级别，分别是:

• 正常:未放大(100%)
• 一级缩放(默认200%)
• 二级缩放(默认400%)

你可以用“SET CAMERA”来定义这些缩放级别。ZOOM-PERCENT [100-MAX] [100-MAX]命令。它配置两个级别将放大的百分比。100是不变焦的，MAX(达到1000)将放大到设备能够放大的范围。第一个参数用于设置1级缩放，第二个参数用于设置2级缩放。

当你想检查当前设置时，你可以使用“GET CAMERA”。zoom - percent”，返回两个值:一级缩放和二级缩放。

例子

readerDevice.dataManSystem() ?。sendCommand(“设置相机。缩放比例250 500")

[readerDevice。dataManSystem sendCommand:@“SET CAMERA.”Zoom-percent 250 500";

下面是另一个命令，设置你想要使用的缩放级别或返回实际设置:"GET/SET CAMERA. "变焦0 - 2”。

SET命令的取值包括:

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

您可以在扫描之前或甚至在扫描期间调用此命令，缩放将上升到配置的级别。

扫描完成后，值重置为正常值(0)。

例子

readerDevice.dataManSystem() ?。sendCommand(“设置相机。放大2”)

[readerDevice。dataManSystem sendCommand:@“SET CAMERA.”放大2”);

当使用移动设备的内置摄像头时，cmbSDK允许您在预览容器中或全屏查看摄像头预览。此预览还包含一个覆盖，可以自定义。cmbSDK相机覆盖层由用于缩放、闪光、关闭扫描仪(全屏)的按钮、指示扫描超时的进度条和相机预览角上的线条构建而成。有两种可用的覆盖:遗留和CMB覆盖。

使用cmbSDK v2.0中使用的传统相机覆盖。xand the ManateeWorks SDK, use this property from MWOverlay before initializing theCMBReaderDevice：

MWOverlay.setOverlayMode (Int32 (OM_LEGACY.rawValue))

[MWOverlay setOverlayMode OM_LEGACY):;

如果使用CMB覆盖，你可以在Resources/layout目录中找到布局文件:必威随行版官网

CMBScannerPartialView.xib当扫描程序在容器内启动时使用(部分视图)

CMBScannerView.xib当扫描仪全屏启动时

复制您需要的布局文件，或两个布局，然后根据需要修改它们。更改视图的大小、位置或颜色，删除视图，并添加自己的视图，如叠加图像。cmbSDK使用的视图(缩放、闪光、关闭按钮、用于在角落上绘制线条的视图和进度条)由sdk使用标签属性，确保标签属性保持不变，以便cmbSDK能够识别视图并继续正确地工作。

CMB和遗留的覆盖层都允许您更改缩放和闪光按钮上使用的图像。要做到这一点，首先复制assets文件夹MWBScannerImages.xcassets从资源目录进入您的必威随行版官网项目。在XCode中，你可以查看这个资产文件夹中包含的图像，并在保持图像名称不变的情况下将它们替换为你自己的图像。

CMB和LEGACY覆盖层都允许您更改检测到条形码时显示的矩形的颜色和宽度。下面是一个如何做到这一点的例子:

MWOverlay.setLocationLineUIColor (UIColor.yellow) MWOverlay.setLocationLineWidth (5)

[MWOverlay setLocationLineUIColor UIColor.yellowColor):;[MWOverlay setLocationLineWidth: 5];

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

附录A包括完整的DMCC参考使用相机阅读器。其他受支持设备(例如MX-1000)的DMCC命令包含在该特定设备的文档中。
附录B提供与相应DMCC设置相关的相机读取器配置设置的默认值。
下面的示例显示了将不同的DMCC命令发送到设备以进行更高级的配置。

例子:

将扫描方向改为全向:

self.readerDevice.dataManSystem() ?。sendCommand(“设置解码器。1D-SYMBOLORIENTATION 0", withCallback: { (response:CDMResponse?) in if response?.status == DMCC_STATUS_NO_ERROR { // Command was executed successfully } else { // Command failed, handle errors here } })

[readerDevice。dataManSystem sendCommand:@"SET DECODER.1D-SYMBOLORIENTATION 0" withCallback:^(CDMResponse *response){if (response. 0)status == DMCC_STATUS_NO_ERROR){//命令执行成功}else{//命令执行失败，处理错误}}];

修改直播预览扫描超时时间为10秒:

self.readerDevice.dataManSystem() ?。sendCommand(“设置解码器。MAX-SCAN-TIMEOUT 10"，在if响应中使用callback:{(响应:CDMResponse?)status == DMCC_STATUS_NO_ERROR{//命令执行成功}否则{//命令执行失败，处理错误}})

[readerDevice。dataManSystem sendCommand:@"SET DECODER. "MAX-SCAN-TIMEOUT 10" withCallback:^(CDMResponse *response){if(响应。status == DMCC_STATUS_NO_ERROR){//命令执行成功}else{//命令执行失败，处理错误}}];

获取连接设备的类型:

self.readerDevice.dataManSystem() ?。sendCommand(“设备。类型", withCallback: { (response:CDMResponse?) in if response?.status == DMCC_STATUS_NO_ERROR { // Command was executed successfully let deviceType:String = response?.payload } else { // Command failed, handle errors here } })

[readerDevice。dataManSystem sendCommand:@"获取设备。类型" withCallback:^(CDMResponse *response){ if (response.status == DMCC_STATUS_NO_ERROR) { // Command was executed successfully NSString *deviceType = response.payload; } else { // Command failed, handle errors here } }];

cmbSDK包括一个将设备重置为默认设置的方法。在MX移动终端的情况下，这是默认保存的配置，而在内置摄像头的情况下，这些是附录B中标识的默认值，其中不启用任何符号。方法如下:

self.readerDevice.resetConfig {(error: error ?) in if error != nil{//重置配置失败，可能原因:阅读器断开，电池没电或线缆未插拔}}

[readerDevice resetConfigWithCompletion:^(NSError *error) {if (error){//重置配置失败，可能原因为:reader断连，电池没电或线缆未插接}}];

有了正确配置的阅读器，就可以扫描条形码了。方法可以简单地实现这一点startScanning ()方法。CMBReaderDevice对象。接下来会发生什么是基于类型CMBReaderDevice以及它是如何配置的。一般来说:

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

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

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

当条形码被成功解码时，您将收到一个CMBReadResults数组的CMBReaderDevice的使用以下方法进行委托CMBReaderDeviceDelegate方法:

func didReceiveReadResult(fromReader reader: CMBReaderDevice, results readResults: CMBReadResults!)

- (void)didReceiveReadResultFromReader:(CMBReaderDevice *)reader results:(CMBReadResults *)readResults;

要简单地显示ReadResult扫描条形码后:

func didReceiveReadResult(fromReader reader: CMBReaderDevice, results readResults: CMBReadResults!) {if readResults.readResults.count > 0 {let readResult:CMBReadResult = readResults.readResults?首先是!如果readResult. CMBReadResult。图像!= nil { self.ivPreview.image = readResult.image } if readResult.readString != nil { self.lblCode.text = readResult.readString } } }

- (void)didReceiveReadResultFromReader:(CMBReaderDevice *)reader results:(CMBReadResults *)readResults {if (readResults.readResults. resultfromreader)count > 0) {CMBReadResult *readResult = readResults.readResults.firstObject;if (readResult.image) {self.ivPreview.image = readResult.image;} if (readResult.readString) {self.lblCode.text = readResult.readString;}}}

在上面的例子中，ivPreview是一个UIImageView用于显示扫描条形码的图像，和lblCode是一个UILabel，用于显示条形码的结果。你也可以使用BOOL fromreadResult.goodRead检查扫描是否成功。

当条码读取成功时，aCMBReadResult对象创建并返回didReceiveReadResultFromReader:结果:方法。在单个图像/帧上成功读取多个条形码的情况下，多个CMBReadResult返回对象。这就是为什么CMBReadResults类的数组CMBReadResult对象，其中包含所有结果。

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

• goodRead(BOOL):表示读取是否成功
• readString(NSString):解码后的条形码字符串
• 图像(UIImage):解码器处理过的图像/帧
• imageGraphics(NSData):条形码作为SVG数据的边界路径
• XML(NSData):解码器返回的原始XML
• 符号学(ccbsymbology):条形码的符号类型。中定义的枚举CMBReaderDevice.h．

当扫描结束而未成功读取时，aCMBReadResult返回与goodRead属性设置为false。这通常发生在扫描被取消或超时时。

以启用映像和imageGraphics属性CMBReadResult对象，则必须设置相应的imageResultEnabled和/或SVGResultEnabled的属性CMBReaderDevice对象．

要查看关于如何并行使用和显示图像和SVG图形的示例，请参阅SDK包中提供的示例应用程序。

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

例子:

解析XML并提取Base64字符串是使用xmlparse委托委托。在你的ViewController中添加这个委托和下面的方法:

// XMLParserDelegate var currentElement = "" var base64String = "" func parser(_ parser: XMLParser, didStartElement elementName: String, namespaceURI: String?， qName:字符串?，属性attributeDict: [String: String] = [:]) {currentElement = elementName} func解析器(_ parser: XMLParser, foundCharacters String: String) {if currentElement == "full_string" {base64String = String}}

#pragma NSXMLParserDelegate;NSString * base64String;- (void)parser:(NSXMLParser *)parser didStartElement:(NSString *)elementName namespaceURI:(NSString *)namespaceURI qualifiedName:(NSString *)qName attributes:(NSDictionary *)attributeDict {currentElement = elementName;} - (void)解析器:(NSXMLParser *)解析器foundCharacters:(NSString *)字符串{if ([currentElement isEqualToString:@"full_string"]) {base64String =字符串;}}

在您设置XMLParserDelegate为了从XML结果中提取base64字符串，您需要创建一个xmlparse对象并使用此委托解析result.xml。中接收扫描结果时可以执行此操作CMBReaderDeviceDelegate，或访问CMBReadResult对象。下面是你如何使用你之前创建的委托来获取原始字节:

let xmlParser: xmlParser = xmlParser。init(data: result.xml) xmlParser.delegate = self if xmlParser.parse(){//通过变量let bytes访问原始字节:data ?=数据。初始化(base64Encoded: base64String)}

NSXMLParser *xmlParser = [NSXMLParser。]alloc initWithData result.XML):;xmlParser.delegate = self;if ([xmlParser parse]){//通过变量NSData *bytes = [NSData. parse]访问原始字节。alloc initWithBase64EncodedString:base64String options:0];｝

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

要启用图像结果，请使用以下方法从CMBReaderDevice类中设置imageResultEnabled属性:

self.readerDevice.imageResultEnabled = true

[readerDevice setImageResultEnabled:是的);

要启用SVG结果，请使用以下方法从CMBReaderDevice类设置imageResultEnabled属性:

self.readerDevice.svgResultEnabled = true

[readerDevice setSVGResultEnabled:是的);

可能会出现由于电池电量不足或手动断开电缆而导致设备断开的情况。这些情况可以通过connectionStateDidChangeOfReader的回调CMBReaderDeviceDelegate．

从非活动状态返回应用程序后，阅读器设备保持初始化，但没有连接。不需要重新初始化SDK，但需要重新连接。

某些iOS版本会在恢复应用程序时发送“可用性”通知，说明外部附件可用。你可以在CMBReaderDeviceDelegate方法:(void)availabilityDidChangeOfReader:(CMBReaderDevice *)reader so w当阅读器可用时，您就可以连接了。

例如:

func availabilityDidChange(ofReader阅读器:CMBReaderDevice) {if(阅读器。available == CMBReaderAvailibilityAvailable) {readerDevice. available == CMBReaderAvailibilityAvailable)连接(completion: { error in if error != nil { // handle connection error } }) } }

- (void)availabilityDidChangeOfReader:(CMBReaderDevice *)reader {if (readerDevice.)availability == CMBReaderAvailibilityAvailable) {[readerDevice connectWithCompletion:^(NSError *error) {if (error){//处理连接错误}}];}}

有些iOS版本不会在简历上报告可用性变化，所以你需要手动处理。为UIApplicationDidBecomeActiveNotification和连接。

例子:

override func viewDidLoad() {super.viewDidLoad() //当应用程序恢复时重新连接NotificationCenter.default.addObserver(self, selector: #selector(self. appbecameactive)， name:NSNotification.Name。UIApplicationDidBecomeActive，对象:nil)} //处理应用程序恢复func appBecameActive() {if readerDevice != nil && readerDevice。availability == CMBReaderAvailibilityAvailable && reader设备。connectionState!= CMBConnectionStateConnecting && readerDevice.connectionState != CMBConnectionStateConnected { readerDevice.connect(completion: { error in if error != nil { // handle connection error } }) } }

- (void)viewDidLoad{//当应用程序恢复时重新连接[[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(appBecameActive) name:UIApplicationDidBecomeActiveNotification object:nil];} //处理应用程序恢复-(无效)appBecameActive {if (readerDevice != nil && readerDevice.}availability == CMBReaderAvailibilityAvailable && reader设备。connectionState!= CMBConnectionStateConnecting && readerDevice.connectionState != CMBConnectionStateConnected) { [readerDevice connectWithCompletion:^(NSError *error) { if (error) { // handle connection error } }]; } }

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