Features

• NEW FEATURE IN VERSION 2.1!
  • ASX playlist support.
• NEW FEATURES IN VERSION 2.0!
  • Realtime audio recording.
  • Improved audio session management.
  • Bandwidth usage statistics.
• Support for the http and mms protocols.
• Supports mp3, aac, aac+ and wma audio streams.
• PLS, M3U, ASX, XSPF and direct URL support.
• Parsing of Shoutcast/Icecast metadata.
• Automatic handling of interruptions like incoming phone calls.
• Background playback.
• Robust error handling.
• Auto reconnect feature.
• Works on Edge/3G/WiFi.

Package

• Complete source code of RadioTunes SDK.
• Detailed documentation with integration instructions.
• Demo Xcode project.
• Fully automated FFmpeg build scripts that will build universal static libraries for the armv7 and i386 architectures.
• Pre-built FFmpeg universal static libraries with support for the mms protocol and wma audio codec.

Code Documentation

All public classes of RadioTunes SDK are documented using appledoc. See the documentation for further information.

Requirements

The source code of RadioTunes SDK is developed on Xcode 4.5.1 with iOS Base SDK 6.0. RadioTunes SDK works on a deployment target of iOS 5 or greater on armv7 and armv7s and can be used in ARC and non-ARC projects.

Integration

RadioTunes SDK can be integrated in two ways into your app.

1. Add the binary RadioTunes.framework

• Drag RadioTunes.framework into the "Frameworks" group of your Xcode project.
• Add the required libraries as shown in the screenshot below. You can add the FFmpeg libraries (libavcodec.a, libavformat.a, libavutil.a and libswresample.a) by dragging them from the "External/ffmpeg/lib" directory into your "Frameworks" group.
• Open the Build Settings tab and apply the following changes:
  • Other Linker Flags -> -all_load -ObjC -lxml2
  • Don't Create Position Independent Executables -> Yes
• Add the "Required background modes" key to your project's plist file and set it's value to "App plays audio".
• Add the following import statement everywhere you want to use RadioTunes SDK: #import <RadioTunes/RadioTunes.h>

2. Add RadioTunes.xcodeproj as a dependency

• Copy the whole RadioTunes folder into your project's root folder.
• Drag RadioTunes.xcodeproj into the "Frameworks" group of your Xcode project.
• Add RadioTunes as a target dependency.
• Add the required libraries as shown in the screenshot below.
• Open the Build Settings tab and apply the following changes:
  • Other Linker Flags -> -all_load -ObjC -lxml2
  • Don't Create Position Independent Executables -> Yes
  • Add the following paths to "Header Search Paths":
    • $(SRCROOT)/RadioTunes/External/ffmpeg/include"
    • $(SRCROOT)/RadioTunes/RadioTunes"
  • Add the following path to "Library Search Paths":
    • **$(SRCROOT)/RadioTunes/External/ffmpeg/lib"
• If your project uses ARC, open the Compile Sources section in the Build Phases tab. Add the -fno-objc-arc compiler flag to all .m source files belonging to RadioTunes SDK!
• Add the "Required background modes" key to your project's plist file and set it's value to "App plays audio".
• Add the following import statement everywhere you want to use RadioTunes SDK: #import "RadioTunes.h"

Sample Usage

YLHTTPRadio *radio = [[YLHTTPRadio alloc] initWithURL:[NSURL URLWithString:@"http://someurl"]];
[radio play];

YLMMSRadio *radio = [[YLMMSRadio alloc] initWithURL:[NSURL URLWithString:@"mms://someurl"]];
[radio play];
[radio startRecordingWithDestination:filePath];