AudioPlayerManager is a small audio player which takes care of the AVPlayer setup and usage. It uses an internal queue to play multiple items automatically in a row. All path based items which are supported from AVPlayer can be used (MPMediaItems and remote URLs).
- iOS 8+
- Xcode 8+
Embedded frameworks require a minimum deployment target of iOS 8 or OS X Mavericks (10.9).
CocoaPods is a dependency manager for Cocoa projects. You can install it with the following command:
$ gem install cocoapodsTo integrate AudioPlayerManager into your Xcode project using CocoaPods, specify it in your Podfile:
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '8.0'
use_frameworks!
target '<Your Target Name>' do
pod 'AudioPlayerManager'
endThen, run the following command:
$ pod installThere two basic usages:
- A singleton player which play one item at a time
AudioPlayerManager.shared.setup()
- Multiple player instances which can be used at the same time
let audioPlayer = AudioPlayerManager.audioPlayer()
In both usage cases you need to setup() the player instance before using it.
AudioPlayerManager.shared.setup()
This will setup the AVAudioSession playback plus activation state and initialize the remote control events plus now playing info center configuration. If you want to modify the basic settings you can this after calling setup.
AudioPlayerManager.shared.setup()
AudioPlayerManager.shared.playingTimeRefreshRate = 1.0
If you want to reveive remote control events you simply have to pass the events from the app delegate to the audio player instace
override func remoteControlReceived(with event: UIEvent?) {
AudioPlayerManager.shared.remoteControlReceivedWithEvent(event)
}
AudioPlayerManager can play local MPMediaItems and stream items from a remote URL. You can pass either one or multiple items to the player.
The following line will replace the current queue of the audio player with the chosen item. The playback will stop automatically if the item was played.
AudioPlayerManager.shared.play(url: self.trackUrl)
If you want to play multiple items you can pass an array and start index. The audio player will replace the current queue with the given array and jump right to the item at the given index. The queue allows the user to rewind also to items with a lower index than the start index.
let songs = (MPMediaQuery.songsQuery().items ?? [])
AudioPlayerManager.shared.play(mediaItems: songs, at: 5)
tschob, Hans Seiffert
AudioPlayerManager is available under the MIT license.