Simple barcode scanner UIView subclass for iOS apps. Quickly and efficiently scans a large variety of barcodes using the iOS device's built in camera.
RMScannerView is a UIView subclass for scanning barcodes in iOS applications. RMScannerView uses advanced barcode scanning built specifically for iOS. Scan both 2D and 1D barcodes such as PDF417, QR, Aztec, EAN, UPC, Code 128, etc. Get a barcode scanner up and running in your iOS app in only a few minutes.
If you like the project, please star it on GitHub! Watch the project on GitHub for updates. If you use RMScannerView in your app, send an email to [email protected] or let us know on Twitter @iRareMedia.
RMScannerView is a great way to integrate barcode scanning in your iOS app. Below are a few key project features and highlights.
- Scan Aztec, Code 128, Code 39, Code 39 Mod 43, Code 93, EAN13, EAN8, PDF417, QR, and UPCE codes.
- Use the iOS device's native hardware / camera and corresponding AVFoundation classes
- Supports tap-to-focus, auto focus, and various other AVCaptureSession features
- Setup only takes a few minutes and can be done almost entirely in interface files
- Access in-depth documentation, code comments, and verbose logging
- Delegate methods, properties, and methods give you complete control over your scan
- Scan animations and scan outlines create a beautiful and dynamic user interface
- iOS Sample-app demonstrates how to quickly and easily setup a RMScannerView
- Frequent updates to the project based on user issues and requests
- Easily contribute to the project
Learn more about the project requirements, licensing, and contributions. Check the Releases section of GitHub for more specific version information.
Requires Xcode 5.0.1 for use in any iOS Project. Requires a minimum of iOS 7.0 as the deployment target. Works with and is optimized for ARC and 64-bit Architecture (arm64).
- Supported build target - iOS 7.0 (Xcode 5.0.1, Apple LLVM compiler 5.0)
- Earliest supported deployment target - iOS 7.0
- Earliest compatible deployment target - iOS 7.0
NOTE: 'Supported' means that the library has been tested with this version. 'Compatible' means that the library should work on this OS version (i.e. it doesn't rely on any unavailable SDK features) but is no longer being tested for compatibility and may require tweaking or bug fixes to run correctly.
You are free to make changes and use this in either personal or commercial projects. Attribution is not required, but it appreciated. A little Thanks! (or something to that affect) would be much appreciated. If you use RMScannerView in your app, send an email to [email protected] or let us know on Twitter @iRareMedia. See the full RMScannerView license here.
Any contribution is more than welcome! You can contribute through pull requests and issues on GitHub. Learn more about contributing to the project here.
The iOS Sample App included with this project demonstrates how to setup and use many of the features in RMScannerView.
All methods, properties, types, and delegate methods available on the RMScannerView class are documented below. If you're using Xcode 5 with RMScannerView, documentation is available directly within Xcode (just Option-Click any method for Quick Help).
Adding RMScannerView to your project is easy. Follow these steps below to get everything up and running.
-
Add the
RMScannerView.h,RMScannerView.m,RMOutlineBox.h, andRMOutlineBox.mfiles into your project -
Import where necessary,
#import "RMScannerView.h" -
Setup the RMScannerView when your UIViewController or view loads:
[scannerView setVerboseLogging:YES]; // Set verbose logging to YES so we can see exactly what's going on [scannerView startCaptureSession]; // Start the capture session when the view loads - this will also start a scan session
-
Add a UIView to the corresponding / desired View Controller and set the view's custom class to
RMScannerView -
Subscribe to the
RMScannerViewdelegate either through the interface (using the outlets inspector) or through code by subscribing to theRMScannerViewDelegateand then setting it.
RMScannerView manages barcode scanning in sessions which can be started or stopped at anytime. There are various session levels, each having a slightly different effect which is suitable for a different period. The capture session is the encompassing session which includes the stream of camera data, scan data, and any animations on the view. The scan session is part of the capture session. It includes only the scan data. A scan session can be stopped separate of the capture session.
There are many methods available on RMScannerView. The most important / highlight methods are documented below. All other methods are documented in the header file and with in-code comments. You should not attempt to use methods which are not listed in the header file.
Starts the current barcode scanner capture session. This method should be called when the encapsulating UIViewController is presented or is loaded, or at any appropriate time. A session will not automatically start when the RMScannerView is loaded (ex. by an interface file). Calling this method begins the AVCaptureSession and starts the collection of camera data - including scan data.
[scannerView startCaptureSession];
Starts a new scanning session and keeps the same capture session (or creates a new one if none exist). This method can be called to start a new scanning session after one has been stopped (ex. automatically after a scan). This will start a new stream of scan data.
[scannerView startScanSession];
You do not need to start both a scan and capture session at the same time. They are mutually inclusive. Starting a scan session will start a capture session if one does not exist or is stopped. Starting a capture session will also start a scan session. However, capture sessions differ from scan sessions in that they are more of an initializer - they do extra setup work and checks that may not be necessary if one is already started.
Stops the current barcode scan. This only prevents the scan data collection. It will not stop any video feed or halt any animations. This method may be called when a scan has completed (if continuous scans are not enabled) but the scanner is still visible on screen.
[scannerView stopScanSession];
Stops the current barcode scanner capture session. This causes the video feed to freeze, animations to halt, and prevents the scan data collection. This method should be called when the encapsulating UIViewController is dismissed, unloaded, or deallocated. Calling this method stops the AVCaptureSession and prevents the collection of any further camera or hardware data - including scan data. It will also remove any animations on the view.
[scannerView stopCaptureSession];
Check if a scan session is in progress. Returns YES if a scan session is currently in progress. NO if either a scan session or a capture session are not in progress.
BOOL isScanning = [scannerView isScanSessionInProgress];
Check if a capture session is in progress. Return YES if a capture session is currently in progress. NO a capture session is not in progress. May return YES even if a scan session is not in progress.
BOOL isCapturing = [scannerView isCaptureSessionInProgress];
If needed, you can display the scanned barcode format to your user with this method. It converts the codeType object passed in the didScanCode:onCodeType: delegate method to a human readable barcode type name. The codeType is an AVMetadataObjectType string passed in the didScanCode:onCodeType: delegate method, or any AVMetadataObjectType barcode string. Returns a human-friendly barcode type name. May return nil if the barcode type is not recognized.
NSString *barcodeType = [scannerView humanReadableCodeTypeForCode:codeType];
Turn the camera flash to ON, OFF, or AUTO for the current scan session.
[scannerView setDeviceFlash:AVCaptureFlashMode];
The most important part of the RMScannerView is it's delegate. Information is sent to the delegate about scanned barcodes. Requests are also sent to the delegate to gather preferences and settings. Error messages may also be sent to the delegate.
When a barcode is recognized and scanned, this delegate method is called. You can use this delegate method to retrieve scan information such as the barcode data and barcode type. This method may be continuously called if the shouldEndSessionAfterFirstSuccessfulScan delegate method returns NO.
- (void)didScanCode:(NSString *)scannedCode onCodeType:(NSString *)codeType;
There are two types of errors that may occur when trying to setup or scan.
The first is a capture session error - a required delegate method. It is sent to the delegate when the scanner fails to properly setup the scan session. This usually occurs because it was started on a device without a camera. A possible solution would be to present the user with a prompt to manually enter the barcode text.
- (void)errorGeneratingCaptureSession:(NSError *)error;
The second is a device hardware lock error - an optional delegate method. It is sent to the delegate when the scanner cannot acquire a hardware lock in order to change configurations. This usually occurs when the user taps-to-focus. This may occur because another running application or process has a lock on the hardware configuration which prevents the scanner from focusing the camera.
- (void)errorAcquiringDeviceHardwareLock:(NSError *)error;
After a barcode is scanned, the scanner must decide to continuously send data to the delegate or to stop sending information after the first successful scan. Use this delegate to specify whether data should continue to be sent or just sent once. Continuous data means that didScanCode:onCodeType: delegate is called repeatedly until the barcode disappears or is no longer readable.
Return YES if the scanner should stop looking for barcodes and reporting them after the first successful scan. NO if the scanner should continuously scan for barcodes. Leaving this delegate method unimplemented will result in the same action as returning YES.
- (BOOL)shouldEndSessionAfterFirstSuccessfulScan;
Customize RMScannerView with various animations and logging. Properties automatically default to NO. To enable a continuous scan laser animation, set the animateScanner property to YES. To enable advanced / verbose logging, set the verboseLogging property to YES.
RMScannerView can also display a box around a scanned barcode (provided the shouldEndSessionAfterFirstSuccessfulScan delegate returns NO) by setting the displayCodeOutline property to YES.