4.4.0

Author: Ricardo Torrão

CHANGELOG.md

@@ -2,6 +2,10 @@
 All notable changes to this project will be documented in this file.
 This project adheres to [Semantic Versioning](http://semver.org/).
 
+## [4.4.0](https://github.com/imaginary-cloud/CameraManager/tree/4.4.0) - 2019-03-12
+### Changed
+- Change callbacks to the swifty way of reporting success and errors (pull request #185)
+
 ## [4.3.1](https://github.com/imaginary-cloud/CameraManager/tree/4.3.1) - 2019-03-08
 ### Fixed
 

CameraManager.podspec

@@ -1,12 +1,12 @@
 Pod::Spec.new do |s|
   s.name             = "CameraManager"
-  s.version          = "4.3.1"
+  s.version          = "4.4.0"
   s.summary          = "This is a simple Swift class to provide all the configurations you need to create custom camera view in your app. Just drag, drop and use."
   s.requires_arc     = true
   s.homepage         = "https://github.com/imaginary-cloud/CameraManager"
   s.license          = 'MIT'
   s.author           = { "torrao" => "rtorrao@imaginarycloud.com" }
-  s.source           = { :git => "https://github.com/imaginary-cloud/CameraManager.git", :tag => "4.3.1" }
+  s.source           = { :git => "https://github.com/imaginary-cloud/CameraManager.git", :tag => "4.4.0" }
   s.social_media_url = 'http://www.imaginarycloud.com/'
   s.platform         = :ios, '9.0'
   s.pod_target_xcconfig = { "SWIFT_VERSION" => "4.2" }

README.md

@@ -1,5 +1,5 @@
-
 # Camera Manager
+
 [![CocoaPods](https://img.shields.io/cocoapods/v/CameraManager.svg)](https://github.com/imaginary-cloud/CameraManager) [![Carthage compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage)
 
 This is a simple Swift class to provide all the configurations you need to create custom camera view in your app.
@@ -15,8 +15,8 @@ The easiest way to install the CameraManager is with [CocoaPods](http://cocoapod
 ```ruby
 use_frameworks!
 
-pod 'CameraManager', '~> 4.3'
-``` 
+pod 'CameraManager', '~> 4.4'
+```
 
 ## Installation with Swift Package Manager
 
@@ -41,27 +41,36 @@ let package = Package(
 Add the following line to your Cartfile:
 
 ```
-github "imaginary-cloud/CameraManager" >= 4.3
+github "imaginary-cloud/CameraManager" >= 4.4
 ```
 
 And run `carthage update` to build the dynamic framework.
 
 ## How to use
+
 To use it you just add the preview layer to your desired view, you'll get back the state of the camera if it's unavailable, ready or the user denied access to it. Have in mind that in order to retain the AVCaptureSession you will need to retain cameraManager instance somewhere, ex. as an instance constant.
+
 ```swift
 let cameraManager = CameraManager()
 cameraManager.addPreviewLayerToView(self.cameraView)
 
 ```
 
 To shoot image all you need to do is call:
+
 ```swift
-cameraManager.capturePictureWithCompletion({ (image, error) -> Void in
-    self.myImage = image             
+cameraManager.capturePictureWithCompletion({ result in
+    switch result {
+        case .failure:
+            // error handling
+        case .success(let content):
+            self.myImage = content.asImage;
+    }
 })
 ```
 
 To record video you call:
+
 ```swift
 cameraManager.startRecordingVideo()
 cameraManager.stopVideoRecording({ (videoURL, recordError) -> Void in
@@ -78,6 +87,7 @@ cameraManager.stopVideoRecording({ (videoURL, recordError) -> Void in
 ```
 
 To zoom in manually:
+
 ```swift
 let zoomScale = CGFloat(2.0)
 cameraManager.zoom(zoomScale)
@@ -86,6 +96,7 @@ cameraManager.zoom(zoomScale)
 ### Properties
 
 You can set input device to front or back camera. `(Default: .Back)`
+
 ```swift
 cameraManager.cameraDevice = .front || .back
 ```
@@ -111,69 +122,82 @@ cameraManager.cameraOutputMode = .stillImage || .videoWithMic || .videoOnly
 ```
 
 You can set the quality. `(Default: .high)`
+
 ```swift
 cameraManager.cameraOutputQuality = .low || .medium || .high
 ```
 
 You can specify the focus mode. `(Default: .continuousAutoFocus)`
+
 ```swift
 cameraManager.focusMode = .autoFocus || .continuousAutoFocus || .locked
 ```
 
 You can specifiy the exposure mode. `(Default: .continuousAutoExposure)`
+
 ```swift
 cameraManager.exposureMode = .autoExpose || .continuousAutoExposure || .locked || .custom
 ```
 
 You can change the flash mode (it will also set corresponding flash mode). `(Default: .off)`
+
 ```swift
 cameraManager.flashMode = .off || .on || .auto
 ```
 
 You can specify the stabilisation mode to be used during a video record session. `(Default: .auto)`
+
 ```swift
 cameraManager.videoStabilisationMode = .auto || .cinematic
 ```
 
 You can enable location services for storing in Camera Roll. `(Default: false)`
+
 ```swift
 cameraManager.shouldUseLocationServices = true || false
 ```
 
 You can specify if you want to save the files to phone library. `(Default: true)`
+
 ```swift
 cameraManager.writeFilesToPhoneLibrary = true || false
 ```
 
 You can specify the album names for image and video recordings.
-```swift 
-cameraManager.imageAlbumName =  "Image Album Name" 
-cameraManager.videoAlbumName =  "Video Album Name" 
+
+```swift
+cameraManager.imageAlbumName =  "Image Album Name"
+cameraManager.videoAlbumName =  "Video Album Name"
 ```
 
 You can specify if you want to disable animations. `(Default: true)`
+
 ```swift
 cameraManager.animateShutter = true || false
 cameraManager.animateCameraDeviceChange = true || false
 ```
 
 You can specify if you want the user to be asked about camera permissions automatically when you first try to use the camera or manually. `(Default: true)`
+
 ```swift
 cameraManager.showAccessPermissionPopupAutomatically = true || false
 ```
 
 To check if the device supports flash call:
+
 ```swift
 cameraManager.hasFlash
 ```
 
 To change flash mode to the next available one you can use this handy function which will also return current value for you to update the UI accordingly:
+
 ```swift
 cameraManager.changeFlashMode()
 ```
 
 You can even setUp your custom block to handle error messages:
 It can be customized to be presented on the Window root view controller, for example.
+
 ```swift
 cameraManager.showErrorBlock = { (erTitle: String, erMessage: String) -> Void in
     var alertController = UIAlertController(title: erTitle, message: erMessage, preferredStyle: .alert)
@@ -195,10 +219,9 @@ cameraManager.showErrorBlock = { (erTitle: String, erMessage: String) -> Void in
 
 Supports iOS 9 and above. Xcode 10.0 is required to build the latest code written in Swift 4.2.
 
-
 Now it's compatible with latest Swift syntax, so if you're using any Swift version prior to 4.2 make sure to use one of the previously tagged releases:
 
-- for Swift 4.0 see: [v4.3.0](https://github.com/imaginary-cloud/CameraManager/tree/4.3.0))
+- for Swift 4.0 see: [v4.4.0](https://github.com/imaginary-cloud/CameraManager/tree/4.4.0))
 
 - for Swift 3.0 see: [v3.2.0](https://github.com/imaginary-cloud/CameraManager/tree/3.2.0)).