Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hackiftekhar/IQAudioRecorderController
A drop-in universal library allows to record audio within the app with a nice User Interface.
https://github.com/hackiftekhar/IQAudioRecorderController
Last synced: 3 months ago
JSON representation
A drop-in universal library allows to record audio within the app with a nice User Interface.
- Host: GitHub
- URL: https://github.com/hackiftekhar/IQAudioRecorderController
- Owner: hackiftekhar
- License: mit
- Created: 2015-01-17T09:33:32.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2018-10-11T07:05:43.000Z (about 6 years ago)
- Last Synced: 2024-07-16T11:34:48.995Z (4 months ago)
- Language: Objective-C
- Homepage:
- Size: 975 KB
- Stars: 637
- Watchers: 28
- Forks: 146
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ios - IQAudioRecorderController - A drop-in universal library allows to record audio within the app with a nice User Interface. (Media / Audio)
- awesome-ios-star - IQAudioRecorderController - A drop-in universal library allows to record audio within the app with a nice User Interface. (Media / Audio)
- Awesome-iOS - IQAudioRecorderController - A drop-in universal library allows to record audio within the app with a nice User Interface. (UI Components)
README
IQAudioRecorderController
`IQAudioRecorderController` is a drop-in universal library allows to record and crop audio within the app with a nice User Interface. There are also optional callback delegate methods to return recorded file path.
## Installation
#### CocoaPods
You can use [CocoaPods](http://cocoapods.org/) to install `IQAudioRecorderController` by adding it to your `Podfile`:
```ruby
platform :ios, '8.0'
use_frameworks!
pod 'IQAudioRecorderController'
```
To get the full benefits import `IQAudioRecorderController` wherever you import UIKit
``` swift
import UIKit
import IQAudioRecorderController
```
#### Manually
1. Download and drop ```/IQAudioRecorderController```folder in your project.
2. Congratulations!
## Supported format
Currently `IQAudioRecorderController` library only support **.m4a** file format.
## Customization
There are optional properties to customize the appearance according to your app theme.
***barStyle: UIBarStyle:***
Library support light and dark style UI for user interface. If you would like to present light style UI then you need to set barStyle to UIBarStyleDefault, otherwise dark style UI is the default.
***normalTintColor: UIColor:***
This tintColor is used for showing wave tintColor while not recording, it is also used for top navigationBar and bottom toolbar tintColor.
***highlightedTintColor: UIColor:***
Highlighted tintColor is used when playing recorded audio file or when recording audio file.
## How to use
There are two seprate classes to Record and Crop Audio files.
To Record audio file, try something like this:-
```objc
#import "IQAudioRecorderViewController.h"
@interface ViewController ()
@end
@implementation ViewController
- (void)recordAction:(id)sender {
IQAudioRecorderViewController *controller = [[IQAudioRecorderViewController alloc] init];
controller.delegate = self;
controller.title = "Recorder";
controller.maximumRecordDuration = 10;
controller.allowCropping = YES;
// controller.barStyle = UIBarStyleDefault;
// controller.normalTintColor = [UIColor magentaColor];
// controller.highlightedTintColor = [UIColor orangeColor];
[self presentBlurredAudioRecorderViewControllerAnimated:controller];
}
-(void)audioRecorderController:(IQAudioRecorderViewController *)controller didFinishWithAudioAtPath:(NSString *)filePath {
//Do your custom work with file at filePath.
[controller dismissViewControllerAnimated:YES completion:nil];
}
-(void)audioRecorderControllerDidCancel:(IQAudioRecorderViewController *)controller {
//Notifying that user has clicked cancel.
[controller dismissViewControllerAnimated:YES completion:nil];
}
@end
```
To Crop audio file, try something like this:-
```objc
#import "IQAudioCropperViewController.h"
@interface ViewController ()
@end
@implementation ViewController
-(void)cropAction:(id)item {
IQAudioCropperViewController *controller = [[IQAudioCropperViewController alloc] initWithFilePath:filePath];
controller.delegate = self;
controller.title = "Edit";
// controller.barStyle = UIBarStyleDefault;
// controller.normalTintColor = [UIColor magentaColor];
// controller.highlightedTintColor = [UIColor orangeColor];
[self presentBlurredAudioCropperViewControllerAnimated:controller];
}
-(void)audioCropperController:(IQAudioCropperViewController *)controller didFinishWithAudioAtPath:(NSString *)filePath {
//Do your custom work with file at filePath.
[controller dismissViewControllerAnimated:YES completion:nil];
}
-(void)audioCropperControllerDidCancel:(IQAudioCropperViewController *)controller {
//Notifying that user has clicked cancel.
[controller dismissViewControllerAnimated:YES completion:nil];
}
@end
```
## Attributions
Thanks to [Stefan Ceriu](https://github.com/stefanceriu) for his brilliant [SCSiriWaveformView](https://github.com/stefanceriu/SCSiriWaveformView) library.
Thanks to [William Entriken](https://github.com/fulldecent) for his [FDWaveformView](https://github.com/fulldecent/FDWaveformView) library.
## LICENSE
Distributed under the MIT license. See ``LICENSE`` for more information.
## Contributions
Any contribution is more than welcome! You can contribute through pull requests and issues on GitHub.
## Author
If you wish to contact me, email at: [email protected]