适用于iOS的康涅克热销手机条码SDK

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

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

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

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

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

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

此外，CMBSDK支持一个活跃的AIMER，它具有自己的内置LED，用于照明和瞄准：MX-100条形码读取器。MX-100是用于连接到移动设备的移动设备的IOS智能手机的移动设备附件。MX-100的内置LED会投影绿点，以帮助阅读条形码。

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

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

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

优化您的应用程序：

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

• 请勿同时启用某些符号系统和/或高级功能。PDF417，DataMatrix和Dotcode是最苛刻的代码，启用了高级功能，它们可以减慢解码时间。
• 优化你的相机分辨率。默认情况下，cmbSDK使用高清图像进行条码解码。
• 使用适当的解码器工作水平。cmbSDK有一个可配置的工作级别，控制它执行图像分析的积极性。cmbSDK使用默认值(级别2)，这对于大多数条形码来说已经足够了。使用更高级别的代码可以更好地解码质量较差的条形码，从而降低性能。

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

1. 打开XCode并启动一个新项目。

2. 添加以下lib和框架到你的项目:

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

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

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

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

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

cmbSDK的使用步骤如下:

1. 初始化要使用的设备类型的读取器设备：MX Reader或Camera Reader。

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-1000，MX-1100等MX移动终端一起使用，简单：只需使用MX设备方法创建读取器设备（它不需要任何参数），并设置适当的委托（通常是自我）：

让readerDevice:CMBReaderDevice = CMBReaderDevice. readerofmx (

CMBReaderDevice *readerDevice = [CMBReaderDevice readerOfMXDevice];readerDevice.delegate =自我;

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

func availabilityDidChange(ofReader reader: CMBReaderDevice)

- （void）availabilitydidchangeofreader :( cmbreaderdevice *）阅读器

使用其他康耐视网络设备

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

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

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

* cdmcamermode * CDMPreviewOption * UIView

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

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

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

• 禁用模拟的硬件触发器。
• 当startScanning ()，则开始解码过程。(寻求CDMPreviewOptionPaused更多的细节)。

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

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

• kcdmameramodepassiveaimer.(PassiveAimer)
  • 当Live-Stream预览时不会显示startScanning ()方法在默认情况下调用。
  • 照明不可用
  • 忽略照明控制命令。

• kCDMCameraModeActiveAimer(mx - 100)
  • 当Live-Stream预览时不会显示startScanning ()方法在默认情况下调用。
  • 照明是可用的，如果预览选项为相机预览启用，照明控制按钮也是可用的。
  • 接受照明或瞄准器控制命令。

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

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

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

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

• kCDMPreviewOptionHighFrameRate:设置摄像头为60帧，而不是默认的30帧，以提供更流畅的摄像头预览。
• kCDMPreviewOptionKeepPreviewInPausedState:读取或超时后，预览保持暂停状态。

例子:

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

让readerdevice：cmbreaderdevice = cmbreaderdevice.readerofdeviceCamera（with：cdmcameramode.noaimer，previewOptions：cdmpreviewoption.init（Rawvalue：0），previewView：nil）ReaderDevice.Delegate = Self

CMBReaderDevice *readerDevice = [CMBReaderDevice readerOfDeviceCameraWithCameraMode: kcdmcameramodenaimer previewOptions:kCDMPreviewOptionDefaults previewView:nil];readerDevice.delegate =自我;

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

让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 =自我;

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

然后使用connectWithCompletion：

//如果self.readerDevice.availability == cmbreaderavailabilityavailable，确保设备已打开并准备就绪;connect(completion: {(error: error ?) in if error != nil{//处理连接错误}})}

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

当连接connectionStateDidChangeOfReader，您可以在其中检查阅读器设备的连接状态connectionState参数。它应该是CMBConnectionStateConnected，这意味着您已成功连接到了CMBReaderDevice，并且可以开始使用Codgex Mobile Barcode 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)symbol enabled:(bool)enabled completion:(void (^)(NSError *error))completionBlock;

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

例子

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

[readerDevice setSymbology:CMBSymbologyQR enabled:YES completion:^(NSError *error){if (error){//启用该符号失败，可能原因是:阅读器断开，电池或电缆未插电，或当前readerDevice不支持符号}}];

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

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

[readerDevice setSymbology:CMBSymbologyUpcEan enabled:NO completion:^(NSError *error){if (error){//启用该符号失败，可能原因是:读取器断开，电池或电缆未插电，或当前readerDevice不支持符号}}];

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

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

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

请记住，并非CMBSDK支持的所有设备和设备模式都允许照明控制。例如，如果在被动瞄准器模式下使用内置摄像机，则由于LED用于瞄准以来，不可用照明。

如果内置摄像头用作阅读器，您有可能配置变焦级别，并定义这些变焦级别的使用方式。

手机摄像头有3个变焦级别，分别是:

• 正常：未放大（100％）
• 1级缩放（默认200％）
• 2级缩放(默认400%)

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

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

例子

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

[readerDevice。dataManSystem sendCommand: @”设置相机。ZOOM-PERCENT 250 500”);

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

set命令的可能值为：

• 0 -法线(未缩放)
• 1 -在1级缩放
• 在第2级缩放

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

当扫描完成时，这些值被重置为normal(0)。

例子

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

[readerDevice。dataManSystem sendCommand: @”设置相机。放大2”);

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

要使用CMBSDK v2.0.x和Manateeworks SDK中使用的传统相机覆盖层，请在初始化之前使用Mwoverlay的此属性CMBReaderDevice：

MWOverlay.setOverlayMode (Int32 (OM_LEGACY.rawValue))

[MWOverlay setOverlayMode OM_LEGACY):;

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

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

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

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

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

CMB和传统叠加都允许您更改检测到条形码时显示的矩形的颜色和宽度。以下是如何执行此操作的示例：

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

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

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

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

例子:

将扫描方向更改为全向导：

self.readerdevice.datamansystem（）？sendcommand（“set解码器.1d-symberorientation 0”，withcallback：{（响应：cdmresponse yexorientation one？）如果响应，则在响应中？.status == dmcc_status_no_error {//命令已成功执行} {//命令失败，在此处处理错误}}）

[ReaderDevice.Datamansystem SendCommand：@“Set DecodeR.1D-Symberorientation 0”用空体：^（CDMResponse *响应）{如果（response.status == dmcc_status_no_error）{//命令已成功执行} else {//命令失败，句柄这里的错误}}];

将直播预览的扫描超时时间更改为10秒:

self.readerDevice.dataManSystem() ?。sendCommand(“设置解码器。MAX-SCAN-TIMEOUT 10"， withCallback: {(response:CDMResponse?) in if response?。status == DMCC_STATUS_NO_ERROR{//命令执行成功}else{//命令执行失败，此处处理错误}})

[readerDevice。dataManSystem sendCommand: @”设置解码器。MAX-SCAN-TIMEOUT 10" withCallback:^(CDMResponse *response){if (response. MAX-SCAN-TIMEOUT 10");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){//重置配置失败，可能原因是:阅读器断开，电池或电缆未插拔}}];

有了正确配置的阅读器，您就可以扫描条形码了。这只需通过调用startScanning ()方法从你CMBReaderDevice对象。接下来会发生什么是基于类型CMBReaderDevice以及它是如何配置的。一般来说:

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

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

• 读者找到并解码了条形码。
• 用户释放触发器或按下Live-Stream Preview屏幕上的STOP按钮。
• 摄像头读取器没找到条形码就超时了。
• 应用程序调用stopScanning ()方法。

当条形码解码成功时，您将收到一个cmbreadresults.在你的数组CMBReaderDevice的使用以下委托cmbreaderdevictionelegate方法:

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 *)结果:读者(CMBReadResults *) readResults{如果(readResults.readResults。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，用于显示来自条形码的结果。也可以使用from的BOOLreadResult.goodRead检查扫描是否成功。

成功读取条形码时，acmbreadresult.对象创建并返回didReceiveReadResultFromReader:结果:方法。如果有多个条形码成功读取在一个图像/帧，多重cmbreadresult.对象返回。这就是为什么cmbreadresults.类具有的数组cmbreadresult.包含所有结果的对象。

的cmbreadresult.类具有描述条形码的结果的属性：

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

当扫描结束而没有成功读取时，acmbreadresult.返回Goodread.属性设置为false。这通常发生在扫描被取消或超时时。

启用图像和imageGraphics属性被填充cmbreadresult.对象，则必须设置相应的imageResultEnabled和/或SVGResultEnabled的属性CMBReaderDevice对象．

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

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

例子:

方法解析XML并提取Base64字符串XMLParser.委托委托。在你的ViewController中添加这个委托和它的以下方法:

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

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

设置完成后XMLParserDelegate要从XML结果中提取base64字符串，您需要创建XMLParser.对象并使用此委托解析result.xml。这可以在接收扫描结果在cmbreaderdevictionelegate，或访问cmbreadresult.对象。下面是如何使用你之前创建的委托来获取原始字节:

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

NSXMLParser *xmlParser = [NSXMLParser. xml]。alloc initWithData result.XML):;xmlParser.delegate =自我;if ([xmlParser parse]){//通过这个变量访问原始字节NSData *bytes = [NSData. html]alloc initWithBase64EncodedString: base64String选项:0);｝

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

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

self.readerDevice.imageResultEnabled = true

[readerDevice setImageResultEnabled:是的);

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

self.readerDevice.svgResultEnabled = true

[ReaderDevice SetSvgresultEnabled：是];

可能会出现设备因电池电量不足或手动断开电缆而断开的情况。这些病例可以被connectionStateDidChangeOfReader回调的cmbreaderdevictionelegate．

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

一些iOS版本会在恢复应用时发送一个“可用性”通知，说明外部附件可用。你可以在cmbreaderdevictionelegate方法:（void）availabilitydidchangeofreader :( cmbreaderdevice *）阅读器如此w当阅读器可用时，你可以连接。

例如:

func availabilityDidChange(ofReader reader: CMBReaderDevice) {if (reader. readerdevice);可用性== cmbreaderavailabilityavailable){读取设备。连接(completion: { error in if error != nil { // handle connection error } }) } }

- （void）可用性DidChangeOfReader :( cmbreaderdevice *）reader {if（readerdevice.availability == cmbreaderavailibilityavailable）{[readerdevice connectwithcompletion：^（nsError *错误）{if（错误）{//处理连接错误}}];}}

有些iOS版本不报告简历的可用性变化，所以你需要手动处理。添加一个观察者UIApplicationDidBecomeActiveNotification和连接。

例子:

override func viewDidLoad() {super.viewDidLoad() //当应用恢复时重新连接NotificationCenter.default.addObserver(self, selector: #selector(self. appbecameactive)， name:NSNotification.Name。UIApplicationDidBecomeActive，对象:nil)} // handle app resume func appBecameActive() {if readerDevice != nil && readerDevice。可用性== cmbreaderavailabilityavailable && readerDevice。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对象:nil];} // handle app resume -(void) appBecameActive {if (readerDevice != nil;可用性== cmbreaderavailabilityavailable && readerDevice。connectionState!= CMBConnectionStateConnecting && readerDevice.connectionState != CMBConnectionStateConnected) { [readerDevice connectWithCompletion:^(NSError *error) { if (error) { // handle connection error } }]; } }

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