mcharters/audjustable

A fast and extensible gapless AudioPlayer/AudioStreamer for OSX and iOS (iPhone, iPad)

Audjustable Audio Streamer

Homepage

Audjustable is an audio streaming class for iOS and OSX. Audjustable uses CoreAudio to decompress and playback audio whilst providing a clean and simple object-oriented API.

The primary motivation of this project was to decouple the input (DataSource/InputStreams) from the actual player logic in order to allow advanced customizable input handling such as: HTTP streaming, encryption, auto-recovery, dynamic-buffering. Along the way other features such as gapless playback were added as the opportunity arose.

Features

• Simple OOP API
• Easy to read source
• Adjustable audio buffering
• Mostly asynchronous API
• Buffered and gapless playback
• Easy to implement audio data sources (HTTP and local file system DataSources provided)
• Easy to extend DataSource to support adaptive buffering, encryption, etc.
• Optimised for low CPU/battery usage

Usage

Download the source which includes a simple audio player project that streams audio over HTTP or locally using the HttpDataSource or LocalFileDataSource classes respectively.

If you would like to integrate the AudioPlayer directly into your project you only need to copy the files inside the /Audjustable/Classes/AudioPlayer directory into your project.

Audjustable is also available as a Cocoapod.

Code

There are two main classes. The DataSource class which is the abstract base class for the various compressed audio data sources (HTTP, local file are provided). The AudioPlayer class manages and renders audio from a queue DataSources.

// Create AudioPlayer

AudioPlayer* audioPlayer = [[AudioPlayer alloc] init];
audioPlayer.delegate = self;

// Queue on a URL to play. Each queue item has a unique ID (item1) that to identify the related file in delegate callbacks

[audioPlayer setDataSource:[audioPlayer dataSourceFromURL:@"https://github.com/downloads/tumtumtum/audjustable/sample.m4a"] withQueueItemId:@"item1"];

Other

Background playback on iOS is easily added to your application by calling the AudioSessionInitialize in your AppDelegate.

Authors and Contributors

Copyright 2012, Thong Nguyen (@tumtumtum)