BarcodeScannerViewController 2.swift 10 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339
  1. import UIKit
  2. import AVFoundation
  3. // MARK: - Delegates
  4. /// Delegate to handle the captured code.
  5. public protocol BarcodeScannerCodeDelegate: class {
  6. func scanner(
  7. _ controller: BarcodeScannerViewController,
  8. didCaptureCode code: String,
  9. type: String
  10. )
  11. }
  12. /// Delegate to report errors.
  13. public protocol BarcodeScannerErrorDelegate: class {
  14. func scanner(_ controller: BarcodeScannerViewController, didReceiveError error: Error)
  15. }
  16. /// Delegate to dismiss barcode scanner when the close button has been pressed.
  17. public protocol BarcodeScannerDismissalDelegate: class {
  18. func scannerDidDismiss(_ controller: BarcodeScannerViewController)
  19. }
  20. // MARK: - Controller
  21. /**
  22. Barcode scanner controller with 4 sates:
  23. - Scanning mode
  24. - Processing animation
  25. - Unauthorized mode
  26. - Not found error message
  27. */
  28. open class BarcodeScannerViewController: UIViewController {
  29. private static let footerHeight: CGFloat = 75
  30. // MARK: - Public properties
  31. /// Delegate to handle the captured code.
  32. public weak var codeDelegate: BarcodeScannerCodeDelegate?
  33. /// Delegate to report errors.
  34. public weak var errorDelegate: BarcodeScannerErrorDelegate?
  35. /// Delegate to dismiss barcode scanner when the close button has been pressed.
  36. public weak var dismissalDelegate: BarcodeScannerDismissalDelegate?
  37. /// When the flag is set to `true` controller returns a captured code
  38. /// and waits for the next reset action.
  39. public var isOneTimeSearch = true
  40. /// `AVCaptureMetadataOutput` metadata object types.
  41. public var metadata = AVMetadataObject.ObjectType.barcodeScannerMetadata {
  42. didSet {
  43. cameraViewController.metadata = metadata
  44. }
  45. }
  46. // MARK: - Private properties
  47. /// Flag to lock session from capturing.
  48. private var locked = false
  49. /// Flag to check if layout constraints has been activated.
  50. private var constraintsActivated = false
  51. /// Flag to check if view controller is currently on screen
  52. private var isVisible = false
  53. // MARK: - UI
  54. // Title label and close button.
  55. public private(set) lazy var headerViewController: HeaderViewController = .init()
  56. /// Information view with description label.
  57. public private(set) lazy var messageViewController: MessageViewController = .init()
  58. /// Camera view with custom buttons.
  59. public private(set) lazy var cameraViewController: CameraViewController = .init()
  60. // Constraints that are activated when the view is used as a footer.
  61. private lazy var collapsedConstraints: [NSLayoutConstraint] = self.makeCollapsedConstraints()
  62. // Constraints that are activated when the view is used for loading animation and error messages.
  63. private lazy var expandedConstraints: [NSLayoutConstraint] = self.makeExpandedConstraints()
  64. private var messageView: UIView {
  65. return messageViewController.view
  66. }
  67. /// The current controller's status mode.
  68. private var status: Status = Status(state: .scanning) {
  69. didSet {
  70. changeStatus(from: oldValue, to: status)
  71. }
  72. }
  73. // MARK: - View lifecycle
  74. open override func viewDidLoad() {
  75. super.viewDidLoad()
  76. view.backgroundColor = UIColor.black
  77. add(childViewController: messageViewController)
  78. messageView.translatesAutoresizingMaskIntoConstraints = false
  79. collapsedConstraints.activate()
  80. cameraViewController.metadata = metadata
  81. cameraViewController.delegate = self
  82. add(childViewController: cameraViewController)
  83. view.bringSubview(toFront: messageView)
  84. }
  85. open override func viewWillAppear(_ animated: Bool) {
  86. super.viewWillAppear(animated)
  87. setupCameraConstraints()
  88. isVisible = true
  89. }
  90. open override func viewWillDisappear(_ animated: Bool) {
  91. super.viewWillDisappear(animated)
  92. isVisible = false
  93. }
  94. // MARK: - State handling
  95. /**
  96. Shows error message and goes back to the scanning mode.
  97. - Parameter errorMessage: Error message that overrides the message from the config.
  98. */
  99. public func resetWithError(message: String? = nil) {
  100. status = Status(state: .notFound, text: message)
  101. }
  102. /**
  103. Resets the controller to the scanning mode.
  104. - Parameter animated: Flag to show scanner with or without animation.
  105. */
  106. public func reset(animated: Bool = true) {
  107. status = Status(state: .scanning, animated: animated)
  108. }
  109. private func changeStatus(from oldValue: Status, to newValue: Status) {
  110. guard newValue.state != .notFound else {
  111. messageViewController.status = newValue
  112. DispatchQueue.main.asyncAfter(deadline: DispatchTime.now() + 2.0) {
  113. self.status = Status(state: .scanning)
  114. }
  115. return
  116. }
  117. let animatedTransition = newValue.state == .processing
  118. || oldValue.state == .processing
  119. || oldValue.state == .notFound
  120. let duration = newValue.animated && animatedTransition ? 0.5 : 0.0
  121. let delayReset = oldValue.state == .processing || oldValue.state == .notFound
  122. if !delayReset {
  123. resetState()
  124. }
  125. if newValue.state != .processing {
  126. expandedConstraints.deactivate()
  127. collapsedConstraints.activate()
  128. } else {
  129. collapsedConstraints.deactivate()
  130. expandedConstraints.activate()
  131. }
  132. messageViewController.status = newValue
  133. UIView.animate(
  134. withDuration: duration,
  135. animations: ({
  136. self.view.layoutIfNeeded()
  137. }),
  138. completion: ({ [weak self] _ in
  139. if delayReset {
  140. self?.resetState()
  141. }
  142. self?.messageView.layer.removeAllAnimations()
  143. if self?.status.state == .processing {
  144. self?.messageViewController.animateLoading()
  145. }
  146. }))
  147. }
  148. /// Resets the current state.
  149. private func resetState() {
  150. locked = status.state == .processing && isOneTimeSearch
  151. if status.state == .scanning {
  152. cameraViewController.startCapturing()
  153. } else {
  154. cameraViewController.stopCapturing()
  155. }
  156. }
  157. // MARK: - Animations
  158. /**
  159. Simulates flash animation.
  160. - Parameter processing: Flag to set the current state to `.processing`.
  161. */
  162. private func animateFlash(whenProcessing: Bool = false) {
  163. let flashView = UIView(frame: view.bounds)
  164. flashView.backgroundColor = UIColor.white
  165. flashView.alpha = 1
  166. view.addSubview(flashView)
  167. view.bringSubview(toFront: flashView)
  168. UIView.animate(
  169. withDuration: 0.2,
  170. animations: ({
  171. flashView.alpha = 0.0
  172. }),
  173. completion: ({ [weak self] _ in
  174. flashView.removeFromSuperview()
  175. if whenProcessing {
  176. self?.status = Status(state: .processing)
  177. }
  178. }))
  179. }
  180. }
  181. // MARK: - Layout
  182. private extension BarcodeScannerViewController {
  183. private func setupCameraConstraints() {
  184. guard !constraintsActivated else {
  185. return
  186. }
  187. constraintsActivated = true
  188. let cameraView = cameraViewController.view!
  189. NSLayoutConstraint.activate(
  190. cameraView.leadingAnchor.constraint(equalTo: view.leadingAnchor),
  191. cameraView.trailingAnchor.constraint(equalTo: view.trailingAnchor),
  192. cameraView.bottomAnchor.constraint(
  193. equalTo: view.bottomAnchor,
  194. constant: -BarcodeScannerViewController.footerHeight
  195. )
  196. )
  197. if navigationController != nil {
  198. cameraView.topAnchor.constraint(equalTo: view.topAnchor).isActive = true
  199. } else {
  200. headerViewController.delegate = self
  201. add(childViewController: headerViewController)
  202. let headerView = headerViewController.view!
  203. NSLayoutConstraint.activate(
  204. headerView.topAnchor.constraint(equalTo: view.topAnchor),
  205. headerView.leadingAnchor.constraint(equalTo: view.leadingAnchor),
  206. headerView.trailingAnchor.constraint(equalTo: view.trailingAnchor),
  207. headerView.bottomAnchor.constraint(equalTo: headerViewController.navigationBar.bottomAnchor),
  208. cameraView.topAnchor.constraint(equalTo: headerView.bottomAnchor)
  209. )
  210. }
  211. }
  212. private func makeExpandedConstraints() -> [NSLayoutConstraint] {
  213. return [
  214. messageView.topAnchor.constraint(equalTo: view.topAnchor),
  215. messageView.leadingAnchor.constraint(equalTo: view.leadingAnchor),
  216. messageView.trailingAnchor.constraint(equalTo: view.trailingAnchor),
  217. messageView.bottomAnchor.constraint(equalTo: view.bottomAnchor)
  218. ]
  219. }
  220. private func makeCollapsedConstraints() -> [NSLayoutConstraint] {
  221. return [
  222. messageView.bottomAnchor.constraint(equalTo: view.bottomAnchor),
  223. messageView.leadingAnchor.constraint(equalTo: view.leadingAnchor),
  224. messageView.trailingAnchor.constraint(equalTo: view.trailingAnchor),
  225. messageView.heightAnchor.constraint(
  226. equalToConstant: BarcodeScannerViewController.footerHeight
  227. )
  228. ]
  229. }
  230. }
  231. // MARK: - HeaderViewControllerDelegate
  232. extension BarcodeScannerViewController: HeaderViewControllerDelegate {
  233. func headerViewControllerDidTapCloseButton(_ controller: HeaderViewController) {
  234. dismissalDelegate?.scannerDidDismiss(self)
  235. }
  236. }
  237. // MARK: - CameraViewControllerDelegate
  238. extension BarcodeScannerViewController: CameraViewControllerDelegate {
  239. func cameraViewControllerDidSetupCaptureSession(_ controller: CameraViewController) {
  240. status = Status(state: .scanning)
  241. }
  242. func cameraViewControllerDidFailToSetupCaptureSession(_ controller: CameraViewController) {
  243. status = Status(state: .unauthorized)
  244. }
  245. func cameraViewController(_ controller: CameraViewController, didReceiveError error: Error) {
  246. errorDelegate?.scanner(self, didReceiveError: error)
  247. }
  248. func cameraViewControllerDidTapSettingsButton(_ controller: CameraViewController) {
  249. DispatchQueue.main.async {
  250. if let settingsURL = URL(string: UIApplicationOpenSettingsURLString) {
  251. UIApplication.shared.openURL(settingsURL)
  252. }
  253. }
  254. }
  255. func cameraViewController(_ controller: CameraViewController,
  256. didOutput metadataObjects: [AVMetadataObject]) {
  257. guard !locked && isVisible else { return }
  258. guard !metadataObjects.isEmpty else { return }
  259. guard
  260. let metadataObj = metadataObjects[0] as? AVMetadataMachineReadableCodeObject,
  261. var code = metadataObj.stringValue,
  262. metadata.contains(metadataObj.type)
  263. else { return }
  264. if isOneTimeSearch {
  265. locked = true
  266. }
  267. var rawType = metadataObj.type.rawValue
  268. // UPC-A is an EAN-13 barcode with a zero prefix.
  269. // See: https://stackoverflow.com/questions/22767584/ios7-barcode-scanner-api-adds-a-zero-to-upca-barcode-format
  270. if metadataObj.type == AVMetadataObject.ObjectType.ean13 && code.hasPrefix("0") {
  271. code = String(code.dropFirst())
  272. rawType = AVMetadataObject.ObjectType.upca.rawValue
  273. }
  274. codeDelegate?.scanner(self, didCaptureCode: code, type: rawType)
  275. animateFlash(whenProcessing: isOneTimeSearch)
  276. }
  277. }