StreamingKit

StreamingKit (formally Audjustable) is an audio streaming library for iOS and OSX. StreamingKit 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 data sources from the actual player logic in order to allow advanced customizable input handling such as HTTP streaming, encryption/decryption, auto-recovery, dynamic-buffering. Along the way other features such as gapless playback were added.

Main Features

• Simple OOP API
• Easy to read source
• 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

Installation

StreamingKit is also available as a Cocoapod and a static lib. You can also simply manually copy all the source files located inside StreamingKit/StreamingKit/* into your project.

Example

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

// Create AudioPlayer

STKAudioPlayer* audioPlayer = [[STKAudioPlayer 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:@"http://fs.bloom.fm/oss/audiosamples/sample.mp3"] withQueueItemId:@"item1"];

More

More documentation is available on the project wiki

Authors and Contributors

Copyright (c) 2012-2014, Thong Nguyen (@tumtumtum)