FeedMedia
Introduction
Feed.fm is a service that allows you to add popular music to your mobile app. The SDK hosted in this repository provides you with simple UI components that you can adapt or use directly in your app.
To report a bug or ask a question, please send an email to [email protected].
Installation
You don't need to download this repository - you can use SPM to add this to your app.
Swift Package Manager
From Xcode 12 onwards you can use Swift Package Manager to add Feed Media to your project.
- Select File > Swift Packages > Add Package Dependency. Enter
https://github.com/feedfm/iOS-SDKin the "Choose Package Repository" dialog. - In the next page, specify the version resolving rule as "Up to Next Major" with "5.0.0" as its earliest version.
- After Xcode checking out the source and resolving the version, you can choose the "FeedMedia" library and add it to your app target.
CocoaPod
You want to add pod 'FeedMedia', '~> 5.1' similar to the following to your Podfile:
target 'MyApp' do
pod 'FeedMedia', '~> 5.1'
end
Then run a pod install inside your terminal, or from CocoaPods.app.
Alternatively to give it a test run, run the command:
pod try FeedMedia
No package manager? No problem!
If want to integrate this library in your application without spm, do the following:
- Clone this repository and drag FeedMedia.xcframeworks folder into frameworks and libraries section of your project. That's it!
Getting started
The SDK centers around a singleton instance of this FMAudioPlayer class, which has simple methods to control music playback (play, pause, skip). The FMAudioPlayer holds a list of FMStation objects (stationList), one of which is always considered the active station (activeStation). Once music playback has begun, there is a current song (currentSong).
Typical initialization and setup is as follows:
As early as you can in your app’s lifecycle (preferably in your AppDelegate or initial ViewController) call
[FMAudioPlayer setclientToken:@"demo" secret:@"demo"]to asynchronously contact the feed.fm servers, validate that the client is in a location that can legally play music, and then retrieve a list of available music stations.
There are a number of sample credentials you can use to assist in testing your app out. Use one of the following strings for your token and secret to get the desired behavior:
‘demo’ - 3 simple stations with no skip limits
‘badgeo’ - feed.fm will treat this client as if it were accessing from outside the US
‘counting’ - a station that just plays really short audio clips of a voice saying the numbers 0 through 9
To receive notice that music is available or not available, use the whenAvailable:notAvailable: method call, which is guaranteed to call only one of its arguments as soon as music is deemed available or not:
FMAudioPlayer *player = [FMAudioPlayer sharedPlayer];
[player whenAvailable:^{
NSLog(@"music is available!");
// .. do something, now that you know music is available
// set player settings
player.crossfadeInEnabled = true;
player.secondsOfCrossfade = 4;
[player play];
} notAvailable: ^{
NSLog(@"music is not available!");
// .. do something, like leave music button hidden
}];
// Set Notifications for ex to listen for player events
[[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(stateDidChange:) name:FMAudioPlayerPlaybackStateDidChangeNotification object:[FMAudioPlayer sharedPlayer]];Tell me more!
Find Appledocs for SDK at demo.Feed.fm
Creating a custom music station requires you to create an account on Feed.fm, but you can try out our sample app here with the included demo credentials. You can also check out our fully pre-built music players RadioPlayer and Radioplayer 2, located on GitHub, that use this library.
Bugs!
If you find a bug, please send an email to [email protected] with a description and any information you have to help us reproduce it.
Authors
License
FeedMedia is available under the MIT license. See the LICENSE.md file for more info.