Skip to content

Alterplay/APAudioPlayer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 

Repository files navigation

APAudioPlayer

Drop-in iOS Audio Player built on top of BASS-library.

###Supported formats:

*.m4a, *.mp3, *.mp2, *.mp1, *.wave, *.ogg, *.wav, *.aiff, *.opus, *.flac, *.wv. ... and even more I haven't tested.

###Dead-simple interface:

Play:

- (BOOL)playItemWithURL:(NSURL *)url;

Pause:

- (void)pause;

Resume:

- (void)resume;

Is playing?:

- (BOOL)isPlaying;

Get current track duration:

- (NSTimeInterval)duration;

Get current track position:

- (NSTimeInterval)position;

Get and set volume:

//0..1
@property (nonatomic, assign) CGFloat volume;

###Dead-simple protocol:

/*
 Will be called when track is over
 */

- (void)playerDidFinishPlaying:(KSAudioPlayer *)player;

/*
 Will be called when interruption occured.
 For ex. phone call.
 Basically you should call - (void)pause in this case.
 */

- (void)playerBeginInterruption:(KSAudioPlayer *)player;

/*
 Will be called when interruption ended.
 For ex. phone call ended.
 It's up to you to decide to call - (void)resume or not.
 */

- (void)playerEndInterruption:(KSAudioPlayer *)player shouldResume:(BOOL)should;

###Integration:

Cocoapods:

pod 'KSAudioPlayer'

Manually:

  1. Drag-and-drop KSAudioPlaeyr folder into your project.
  2. Add AVFoundation.framework to your project
  3. Instantiate KSAudioPlayer and have fun:
//Somewhere during init
self.player = [KSAudioPlayer new];

//Somewhere else
NSURL *fileURL = [[NSBundle mainBundle] URLForResource:@"Meat Loaf - Dead Ringer" withExtension:@"wv"];
[self.player playItemWithURL:fileURL];

###BASS:

BASS is an audio library for use in software on several platforms. Its purpose is to provide developers with powerful and efficient sample, stream (MP3, MP2, MP1, OGG, WAV, AIFF, custom generated, and more via OS codecs and add-ons), MOD music (XM, IT, S3M, MOD, MTM, UMX), MO3 music (MP3/OGG compressed MODs), and recording functions. All in a compact DLL that won't bloat your distribution.

http://www.un4seen.com

http://www.un4seen.com/bass.html#license

###What's next?:

  1. Seek to time.
  2. Online streaming.

Contacts

If you have improvements or concerns, feel free to post an issue and write details.

Check out all Alterplay's GitHub projects. Email us with other ideas and projects.