Cognex移动条码为iOS SDK

不同的智能手机和专用扫描的条形码扫描功能导致不同的用户体验,影响移动条形码扫描应用程序的设计。遵循一些简单的指南,你可以开发应用程序的cmbSDK工作时相同的方式使用一个MX移动终端或移动设备的内置摄像头。这里有一些从链接:

• 没有专用硬件触发启动条形码扫描,看看移动设备触发。
• 为条码扫描目标没有瞄准手的智能手机,看到的移动设备的目标。
• 选择最合适的条码扫描方向,明白了移动设备定位。
• 减少CPU使用的移动设备执行图像分析和条码解码时,看到的优化移动设备性能。

没有硬件触发,移动设备必须使用替代方法进行条码扫描。cmbSDK支持三种方法来触发条码扫描:

• 应用程序或工作流驱动触发:应用程序代码或应用程序的业务逻辑/工作流调用扫描模块通过调用startScanner ()函数。
• 虚拟触发:启动或停止扫描过程,应用程序提供了一个虚拟按钮在屏幕上。根据应用程序设计,你需要按住虚拟按钮继续调用运行的扫描仪扫描模块。
• 模拟触发:新闻的一个音量控制按钮来启动或停止扫描过程就像当你把一个触发器专用扫描仪。

内置摄像头提供直播预览显示的移动设备,可以在部分或全部屏幕中,横向或纵向,条形码的目标。重新定位的移动设备,直到条形码出现在视野的内置摄像头和解码应用程序。

cmbSDK支持被动埃梅认为:设备连接到移动设备或设备的情况下,使用LED闪光灯作为光源项目目标或目标模式。移动设备可以项目瞄准手的模式类似于专用扫描仪所以不需要在线预览。

此外CmbSDK支持积极瞄准手,有自己的内置led照明和目标:mx - 100条形码阅读器。的mx - 100是一个移动设备配件iOS智能手机连接到移动设备与移动设备的情况。mx - 100项目的内置了一个绿点,帮助阅读条形码。

cmbSDK支持肖像取向、横向和自动旋转的表示条码预览和扫描方向。移动设备最能扫描条形码不管应用程序和移动设备的方向。

为更好的读性能读取QR数据矩阵,和Maxicode肖像取向,并在横向长码PDF417。

cmbSDK为移动环境优化,但图像分析和条码解码仍然是CPU密集型活动。由于这些进程共享CPU的移动设备的移动操作系统(OS),服务,和其他应用程序,以下流程优化你的条形码扫描应用程序并限制它只使用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. 如果您使用的是cmbSDK MX移动终端,您还需要添加支持外部附属协议或UISupportedExternalAccessoryProtocols来com.cognex.dmcc在你的项目的Info.plist。(你必须创建一个小额信贷机构请求之前,在这种情况下发布你的应用在苹果应用商店。你可以阅读更多细节让你的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设备方法(它不需要参数),并设置适当的委托(通常自我):

让readerDevice: CMBReaderDevice = CMBReaderDevice.readerOfMX () readerDevice.delegate =自我

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

MX移动终端的可用性可以改变设备打开或关闭时,或如果闪电电缆连接或断开连接。你可以使用以下处理这些变化CMBReaderDeviceDelegate方法。

func availabilityDidChange (ofReader读者:CMBReaderDevice)

- (void) availabilityDidChangeOfReader: (CMBReaderDevice *)读者

使用其他Cognex网络设备

如果你想连接到Cognex设备在网络上(e。g手持或固定架)必须使用另一个命名为框架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。可以指定多个选项和ing时传递参数。可用的选项如下:

• kCDMPreviewOptionDefaults:接受所有默认值设定的CameraMode。
• kCDMPreviewOptionNoZoomBtn直播:隐藏变焦按钮预览。
• kCDMPreviewOptionNoIllumBtn直播:隐藏照明按钮预览。
• kCDMPreviewOptionHwTrigger:使模拟硬件触发(音量)开始扫描。当按下时,扫描开始。
• kCDMPreviewOptionPaused:显示时的即时预览startScanning ()方法被调用时没有开始解码(即寻找条形码)。按屏幕上的扫描按钮开始解码。
• kCDMPreviewOptionAlwaysShow:力的即时预览时主动或被动的目标模式选择(如。CameraMode = = kCDMCameraModePassiveAimer)
• kCDMPreviewOptionPessimisticCaching:只使用当CameraMode = = kCDMCameraModeActiveAimer,这将读取的设置ActiveAimer当应用程序恢复从背景,以防瞄准手设置改变从另一个应用程序。

• kCDMPreviewOptionHighResolution:使用该设备在高分辨率相机帮助小条形码扫描,但缓慢的解码时间。选择分辨率设置为1920 x1080设备上支持它,和默认的设备上没有。默认的分辨率为1280 x720。

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

例子:

创建一个读者没有瞄准手和一个全屏幕直播预览:

让readerDevice: CMBReaderDevice = CMBReaderDevice。readerOfDeviceCamera (: CDMCameraMode。noAimer previewOptions: CDMPreviewOption。init (rawValue: 0), previewView: nil) readerDevice.delegate =自我

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

创建一个读者没有瞄准手,没有变焦按钮,并使用一个模拟触发:

让readerDevice: CMBReaderDevice = CMBReaderDevice。readerOfDeviceCamera (: CDMCameraMode。noAimer previewOptions: [CDMPreviewOption。noZoomBtn CDMPreviewOption。hwTrigger], previewView: nil) readerDevice.delegate =自我

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

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

然后连接使用connectWithCompletion:

/ /确保设备打开,如果self.readerDevice准备。可用性= = CMBReaderAvailibilityAvailable{/ /创建对象和设备self.readerDevice readerDevice之间的连接。连接(完成:{(错误:错误?)如果错误! = nil{/ /处理连接错误}})}

/ /确保设备打开,如果(readerDevice准备。可用性= = CMBReaderAvailibilityAvailable){/ /创建readerDevice之间的连接对象和设备(readerDevice connectWithCompletion: ^ (NSError *误差){如果(错误){/ /处理连接错误}});}

当连接connectionStateDidChangeOfReader在调用委托,你可以检查你的读者设备的连接状态connectionState参数。它应该是CMBConnectionStateConnected,这意味着您已经成功连接CMBReaderDevice,就可以开始使用Cognex移动条形码SDK。

更改一些设置在连接到设备cmbSDK提供了一组高级设备独立api来设置和检索当前配置的设备。

使用一个MX读者之间的差异和扫描相机的读者是下面几节详细讨论。

移动终端的MX的家庭提供了先进的设备配置和管理包括在设备上保存配置。MX设备来Cognex预配置与大多数象征学和功能可以使用了。

如果你想自定义配置,配置通过,DataMan设置工具,或Cognex快速设置。这两个工具都容易保存配置分发给多个设备进行简单的配置管理。

移动应用程序能够配置MX设备给你选择:

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

cmbSDK雇佣了一个默认的选项集条码阅读的内置摄像头的移动设备。然而,要记住的有两个重要的差别:

• cmbSDK没有实现保存配置内置摄像头的读者。每次应用程序使用相机的读者开始自动默认值基于“增大化现实”技术的使用。
• cmbSDK不启用默认象征学。应用程序程序员使所有条形码象征学扫描应用程序中。必要的,只有需要明确象征学,应用程序达到最优扫描移动设备的性能。

mx - 100是device-case附件仅供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的责任。有不同的缓存对于不同的设置:
  • 持久缓存:设置/值很少改变(如果有的话)和iPhone SDK可以缓存一段时间了。这些物品是mx - 100编号,型号,固件版本。持久缓存更新每7天。
  • 会话缓存:设置/的值可能会改变在一个应用程序使用一个mx - 100(不太可能),但应该读的mx - 100 SDK mx - 100 /初始连接的负载。这些项目是:瞄准手强度,瞄准手调制,瞄准手超时,光照强度和照明状态。
    默认情况下,会话缓存将保持乐观的最佳性能。SDK假设另一个应用程序并不是改变瞄准手的设置,SDK只需要读瞄准手的设置一个时间,当初始建立连接。

个人象征学可以启用使用以下的方法CMBReaderDevice对象:

- (void) setSymbology: (CMBSymbology)符号:启用(bool)启用完成:(空白(^)(NSError *误差))completionBlock;

所有用于符号象征学参数在此方法中可以找到CMBReaderDevice.h。

例子

self.readerDevice。setSymbology (CMBSymbologyQR启用:真的,完成:{(_错误:错误?)- >空白如果错误! = nil{/ /未能使符号学,可能的原因是:读者断开连接,电池或电缆不插电,或标记不支持当前readerDevice}})

[readerDevice setSymbology: CMBSymbologyQR启用:是的完成:^ (NSError *误差){如果(错误){/ /未能使符号学,可能的原因是:读者断开连接,电池或电缆不插电,或标记不支持当前readerDevice}});

同样的方法也可以用来关闭象征学:

self.readerDevice。setSymbology (CMBSymbologyUpcEan启用:假的,完成:{(_错误:错误?)- >空白如果错误! = nil{/ /未能使符号学,可能的原因是:读者断开连接,电池或电缆不插电,或标记不支持当前readerDevice}})

[readerDevice setSymbology: CMBSymbologyUpcEan启用:没有完成:^ (NSError *误差){如果(错误){/ /未能使符号学,可能的原因是:读者断开连接,电池或电缆不插电,或标记不支持当前readerDevice}});

如果你的读者设备配备照明(例如发光二极管),您可以控制是否打开或关闭扫描开始时使用以下的方法CMBReaderDevice对象:

self.readerDevice.setLightsON(真正的){(错误:错误?)如果错误! = nil{/ /未能使照明,可能的原因是:读者断开连接,电池或电缆不插电,或设备没有附带照明灯光}}

[readerDevice setLightsON:是的完成:^ (NSError *误差){如果(错误){/ /未能使照明,可能的原因是:读者断开连接,电池或电缆不插电,或设备没有附带照明灯光}});

请记住,并不是所有的设备和设备支持的模式cmbSDK允许照明控制。例如,如果使用内置摄像头在被动瞄准手模式中,照明因为领导不在被用于瞄准。

如果使用内置摄像头作为读者设备配置的缩放级别的可能性和定义的方式使用这些缩放级别。

有三个缩放级别的手机相机,这是:

• 正常:不放大(100%)
• 1级变焦(默认200%)
• 2级变焦(默认400%)

您可以定义这些缩放级别与“相机。ZOOM-PERCENT [100 - max] [100 - max)”命令。它配置两个层面将放大多少百分比。100没有变焦,马克斯(上升到1000)将放大的设备的能力。第一个参数用于设置一级放大,而第二个二级放大。

当你想要检查当前的设置,你可以与“相机。ZOOM-PERCENT”返回两个值:1级和2级放大。

例子

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

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

这是另一个命令,设置您想要使用的缩放级别或返回的实际设置:“获取/设置相机。变焦0 - 2”。

SET命令可能的值是:

• 0 -正常(un-zoomed)
• 1 - 1级放大
• 2 - 2级放大

你可以叫这个命令之前扫描甚至在扫描过程中,缩放上升到配置水平。

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

例子

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

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

当使用移动设备的内置camrea, cmbSDK允许你看到相机预览在容器或在全屏预览。这个预览版还包含一个覆盖,可以定制。cmbSDK相机覆盖由变焦按钮,flash,关闭扫描仪(全屏),进度条显示扫描超时,线条的相机预览。有两种可用的覆盖:遗产和招商银行覆盖。

使用传统相机覆盖,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):;

如果使用招商银行的叠加,可以发现资源/布局的布局文件目录:必威随行版官网

CMBScannerPartialView.xib使用扫描仪时开始在容器(部分视图)

CMBScannerView.xib当扫描仪始于全屏

你需要复制的布局文件,或两个布局,然后修改它们。改变大小,位置和颜色的观点,删除视图,并添加您自己的观点,就像一个覆盖图像。使用的视图cmbSDK(缩放、flash,关闭按钮,视图用于绘制线条的角落,和进度条)是由sdk访问使用标签属性,确保标签属性保持不变,所以cmbSDK能够认识到视图和继续正常工作。

招商银行和遗留覆盖允许您更改使用的图像缩放和flash按钮。要做到这一点,首先复制文件夹以外的资产MWBScannerImages.xcassets从资源dir到您的必威随行版官网项目。在XCode中你可以看看这个资产中包含的图片文件夹,并代之以自己的同时保持图像的名字不变。

招商银行和遗留覆盖允许您更改的颜色和宽度矩形显示当一个条形码检测。这里有一个例子怎么做:

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

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

每个Cognex扫描装置实现,DataMan控制命令(DMCC)、配置和控制设备的方法。几乎所有设备的特性可以控制使用这个基于文本的语言。API提供了一种方法将DMCC命令发送到设备。命令设置和查询配置属性存在。

附录A包括完整的DMCC使用相机的读者参考。DMCC命令支持对其他设备(如mx - 1000)中包含的文档的特定设备。
附录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: @“设置DECODER.1D-SYMBOLORIENTATION 0”withCallback: ^ (CDMResponse *响应){如果(响应。状态= = DMCC_STATUS_NO_ERROR){/ /命令成功执行}其他{/ /命令失败,处理错误}});

改变扫描直播预览到10秒的超时:

self.readerDevice.dataManSystem () ?。sendCommand(“设置解码器。MAX-SCAN-TIMEOUT 10”, withCallback:{如果反应(响应:CDMResponse ?) ?。状态= = DMCC_STATUS_NO_ERROR其他{/ /命令成功执行}{/ /命令失败,处理错误}})

[readerDevice。dataManSystem sendCommand: @”设置解码器。MAX-SCAN-TIMEOUT 10“withCallback: ^ (CDMResponse *响应){如果(响应。状态= = DMCC_STATUS_NO_ERROR){/ /命令成功执行}其他{/ /命令失败,处理错误}});

连接设备的类型:

self.readerDevice.dataManSystem () ?。sendCommand(“设备。类型”,withCallback:{如果反应(响应:CDMResponse ?) ?。状态= = DMCC_STATUS_NO_ERROR{/ /命令成功执行让deviceType:字符串=反应?。其他载荷}{/ /命令失败,处理错误}})

[readerDevice。dataManSystem sendCommand: @”设备。类型“withCallback: ^ (CDMResponse *响应){如果(响应。状态= = DMCC_STATUS_NO_ERROR){/ /命令成功执行NSString * deviceType = response.payload;其他}{/ /命令失败,处理错误}});

cmbSDK包括重置设备其默认设置的方法。对于一个MX移动终端,这是配置保存在默认情况下,在内置摄像头的情况下,这些违约标识在附录B,象征学不会启用。该方法如下:

self.readerDevice。resetConfig{(错误:错误?)如果错误! = nil{/ /重置配置失败,可能原因是:读者断开连接,电池或电缆不插电}}

[readerDevice resetConfigWithCompletion: ^ (NSError *误差){如果(错误){/ /重置配置失败,可能原因是:读者断开连接,电池或电缆不插电}});

正确配置的读者,你准备扫描条形码。这是通过调用来完成startScanning ()方法从你CMBReaderDevice对象。接下来会发生什么是基于类型的CMBReaderDevice和它如何被配置。一般来说:

• 如果使用一个MX终端,按设备上的触发按钮打开和读取条形码扫描器。
• 如果读者使用相机,cmbSDK启动摄像头,显示配置的直播预览,并开始从视频流分析框架,寻找一个条形码符号配置。

扫描停止在下列条件之一:

• 读者发现并解码的条形码。
• 用户发布触发器或直播预览屏幕上按下停止按钮。
• 相机没有找到条形码阅读器超时。
• 应用程序调用stopScanning ()方法。

当条码解码成功,你将收到一个CMBReadResults在你的数组CMBReaderDevice的委托使用以下CMBReaderDeviceDelegate方法:

func didReceiveReadResult (fromReader读者:CMBReaderDevice,结果readResults: CMBReadResults !)

- (void) didReceiveReadResultFromReader:读者(CMBReaderDevice *)结果:readResults (CMBReadResults *);

只显示一个ReadResult扫描条码后:

func didReceiveReadResult (fromReader读者:CMBReaderDevice,结果readResults: CMBReadResults !)如果readResults.readResults {。数> 0{让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。数> 0){CMBReadResult * readResult = readResults.readResults.firstObject;如果(readResult.image) {self.ivPreview。形象= readResult.image;如果(readResult.readString) {self.lblCode}。文本= readResult.readString;}}}

在上面的示例中,ivPreview是一个UIImageView用于显示图像的条码扫描,然后呢lblCode是一个从条形码UILabel用来显示结果。您还可以使用布尔值readResult.goodRead检查扫描是否成功与否。

当一个成功读取条形码,CMBReadResult对象创建和返回的didReceiveReadResultFromReader:结果:方法。如果有多个条形码成功读取单个图像/框架上,多个CMBReadResult对象返回。这就是为什么CMBReadResults类的数组CMBReadResult对象包含所有结果。

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

• goodRead(保龄球):告诉读成功与否
• readString(NSString):条码解码为字符串
• 图像(用户界面图像):图像/帧解码器已经处理
• imageGraphics(NSData):边界barcodeas SVG的路径数据
• XML(NSData):返回的译码器的原始XML
• 符号学(CMBSymbology):符号类型的条形码。这个枚举中定义CMBReaderDevice.h。

扫描结束后,没有成功的阅读,一个CMBReadResult返回的goodRead属性设置为false。这通常发生在扫描取消或超时。

使图像和imageGraphics属性被填满CMBReadResult对象,您必须设置相应的imageResultEnabled和/或SVGResultEnabled的属性CMBReaderDevice对象。

看到一个例子如何使用图像和SVG图形并显示在平行,参考SDK提供的示例应用程序包。

访问原始字节从扫描条形码,可以使用XML属性。字节存储作为Base64字符串“full_string”标签下。这里有一个例子如何使用iOS XML解析器来提取原始字节从XML属性。

例子:

解析XML并提取Base64字符串使用完成xmlparse委托委托。添加这个委托和从在ViewController下列方法:

/ / XMLParserDelegate var currentElement = " " var base64String = "函数解析器(_解析器:xmlparse didStartElement elementName:字符串,namespaceURI:字符串?,qualifiedName qName:字符串?、属性attributeDict:[字符串:String] = [:]) {currentElement = elementName}函数解析器(_解析器:xmlparse foundCharacters字符串:字符串){如果currentElement = =“full_string”{base64String =字符串}}

# pragma NSXMLParserDelegate NSString * currentElement;NSString * base64String;- (void)解析器:(NSXMLParser *)解析器didStartElement: (NSString *) elementName namespaceURI: (NSString *) namespaceURI qualifiedName: (NSString *) qName属性:(NSDictionary < NSString *、NSString * > *) attributeDict {currentElement = elementName;}- (void)解析器:(NSXMLParser *)解析器foundCharacters:字符串(NSString *){如果([currentElement isEqualToString: @ " full_string "]) {base64String =字符串;}}

后设置XMLParserDelegate从XML提取base64字符串的结果,您需要创建一个xmlparse对象和解析结果。xml使用这个委托。可以当收到扫描的结果CMBReaderDeviceDelegate,或者当访问CMBReadResult对象。这是如何得到原始字节使用前面创建的委托:

让xmlparse: xmlparse = xmlparse。init(数据:result.xml) xmlParser.delegate =自我如果xmlParser.parse(){/ /通过该变量让字节:访问原始字节数据?=数据。init (base64Encoded: base64String)}

NSXMLParser * xmlparse = [NSXMLParser。alloc initWithData result.XML):;xmlParser.delegate =自我;如果([xmlparse解析]){/ /通过该变量访问原始字节NSData *字节= [NSData。alloc initWithBase64EncodedString: base64String选项:0);}

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

使图像结果,设置imageResultEnabled属性从CMBReaderDevice类通过使用下面的方法:

self.readerDevice。imageResultEnabled= true

[readerDevice setImageResultEnabled:是的);

使SVG的结果,设置imageResultEnabled属性从CMBReaderDevice类通过使用下面的方法:

self.readerDevice。svgResultEnabled = true

[readerDevice setSVGResultEnabled:是的);

可能存在情况下断开设备由于电池电量不足情况或手动电缆断开。这种情况下可以检测到的connectionStateDidChangeOfReader回调的CMBReaderDeviceDelegate。

回到您的应用程序免受非活动状态后,读者设备仍是初始化但没有连接。不需要重新初始化SDK,但你需要贯通。

iOS版本恢复时将发送一个“可用性”通知的应用程序可用的外部配件。你可以使用这个CMBReaderDeviceDelegate方法:(空白)availabilityDidChangeOfReader: w (CMBReaderDevice *)读者母鸡读者可用,你可以连接。

例如:

func availabilityDidChange (ofReader读者:CMBReaderDevice){如果读者。可用性= = {readerDevice CMBReaderAvailibilityAvailable)。连接(completion: { error in if error != nil { // handle connection error } }) } }

- (void) availabilityDidChangeOfReader:{如果(readerDevice (CMBReaderDevice *)读者。可用性= = CMBReaderAvailibilityAvailable) {[readerDevice connectWithCompletion: ^ (NSError *误差){如果(错误){/ /处理连接错误}});}}

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

例子:

覆盖func viewDidLoad () {super.viewDidLoad() / /重新连接时应用简历NotificationCenter.default.addObserver(自我,选择器:#选择器(self.appBecameActive)名称:NSNotification.Name。UIApplicationDidBecomeActive,对象:nil)} / /处理程序恢复func appBecameActive(){如果readerDevice ! = nil & & readerDevice。= = CMBReaderAvailibilityAvailable & & readerDevice可用性。connectionState!= CMBConnectionStateConnecting && readerDevice.connectionState != CMBConnectionStateConnected { readerDevice.connect(completion: { error in if error != nil { // handle connection error } }) } }

- (void) viewDidLoad{/ /重新连接,当应用程序恢复[[NSNotificationCenter defaultCenter] addObserver:自我选择器:@ selector (appBecameActive)名称:UIApplicationDidBecomeActiveNotification对象:nil);}/ /处理程序的简历- (void) appBecameActive{如果(readerDevice ! = nil & & readerDevice。= = CMBReaderAvailibilityAvailable & & readerDevice可用性。connectionState!= CMBConnectionStateConnecting && readerDevice.connectionState != CMBConnectionStateConnected) { [readerDevice connectWithCompletion:^(NSError *error) { if (error) { // handle connection error } }]; } }

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