calm / persistentstreamplayer Goto Github PK

Stream audio over http, and persist the data to a local file while buffering

License: MIT License

Objective-C 96.24% Ruby 3.76%

ios swift objective-c persistence player audio video streaming

persistentstreamplayer's Introduction

PersistentStreamPlayer

Handles the playing of an audio file while streaming, and saves the data to a local URL as soon as the stream completes. Battle-tested in the production version of Calm

Installation

Add this to your Podfile

pod 'PersistentStreamPlayer'

Usage

PersistentStreamPlayer *remoteAudioPlayer = [[PersistentStreamPlayer alloc] initWithRemoteURL:myHTTPURL
                                                                                     localURL:myFileURL];
remoteAudioPlayer.delegate = self;
[remoteAudioPlayer play];

Features

streaming of audio file, starting playback as soon as first data is available
also saves streamed data to a file URL as soon as the buffer completes
simple play, pause and destroy methods (destroy clears all memory resources)
ability to seamlessly loop the audio file. call player.looping = YES
exposes timeBuffered, helpful for displaying buffer progress bars in the UI
handles re-starting the audio file after the buffer stream stalls (e.g. slow network)
does not keep audio file data in memory, so that it supports large files that don't fit in RAM

The PersistentStreamPlayerDelegate protocol has some helpful event indicators, all optional:

/* called when the data is saved to localURL */
- (void)persistentStreamPlayerDidPersistAsset:(PersistentStreamPlayer *)player;

/* called when the audio file completed */
- (void)persistentStreamPlayerDidFinishPlaying:(PersistentStreamPlayer *)player;

/* called when the play head reaches the buffer head */
- (void)persistentStreamPlayerStreamingDidStall:(PersistentStreamPlayer *)player;

/* called as soon as the asset loads with a duration, helpful for showing a duration clock */
- (void)persistentStreamPlayerDidLoadAsset:(PersistentStreamPlayer *)player;

/* on failure to load asset */
- (void)persistentStreamPlayerDidFailToLoadAsset:(PersistentStreamPlayer *)player;

persistentstreamplayer's People

Contributors

Stargazers

Watchers

persistentstreamplayer's Issues

Not working with endless streams (radio streams)

Thanks for your work.
i've tried to get this to work with radio streams which are endless stream , but it did not work

override func viewDidLoad() {
         super.viewDidLoad()
       let filemgr = FileManager.default
       // let currentPath = filemgr.currentDirectoryPath
        let dirPaths = filemgr.urls(for: .documentDirectory, in: .userDomainMask)

        let docsDir = dirPaths[0].path
        print("docsDir = \(docsDir)")
       let url = URL(string: "http://mp3channels.webradio.antenne.de/oldies-but-goldies")!
        let player = PersistentStreamPlayer(remoteURL: url, localURL: dirPaths[0])
       player?.delegate = self
       
       player?.play()
       print("loaded")

     }

any hint please

Implement seekToTime that guarantees that the bits save to the disk in the proper order

I'm not aware of good documentation on what order the bits will stream to resourceLoader:shouldWaitForLoadingOfRequestedResource:

I left a comment in the code about this here

So right now I believe it's only guaranteed to work if you only ever seek back rather than forward. I believe large forward seeks allow the OS to never fetch any of the bits that occurred in the middle. Anyone have more domain expertise on how the system handles seeks?

crashes if device runs out of space while streaming to disk

@tsheaff commented on Wed Oct 26 2016

Should wrap writeData: in a try-catch. Any better means of handling the catch than by simply swallowing?

Player starts randomly when Screen is locked

Hey there,

I've build in the PersistentStreamPlayer and works as expected!

However, I'm facing some issues when the iPhone locked, or when unlocking the iPhone. When unlocking the Screen, the player starts playing.

I'm using the AppDelegate class to stop the player right away, but it's still playing for about 0.5 seconds.

Another case is when starting the player, stopping it, locking the screen & then activating the screen (Not unlocking). The player starts playing then.

The second case is only in iOS 13, the first case even in lower versions.

Any ideas on how I can fix this? Do you need some more infos?

readyToPlay events fires only once video is down loading entirely

The readyToPlay fires only once video is down loading entirely, instead of shortly after the video started streaming. I've found that this is because the player is making range requests at the end of the file early on (I guess this is related to how mp4 are encoded) and they are only responded once the corresponding data is fetched, which is when the file is downloaded. I don't remember the specific yet, but what I observed in the requests passed to shouldWaitForLoadingOfRequestedResource was something like:

range: 0-2
range: 9900 - 10000
range: 2-...

for a file of byte length 10000. You get the idea. The second request is not responded to until all the file is downloaded, since the data is downloaded in the order it's written in the file. This is delaying the ready to play event

Stop or Play Next

Hi, some background, I am using the player in a music app as the music player. So skip songs in playlists etc.. I have integrated the persistent stream player into our project and it works so far as:

Play a stream, persistence, download etc.
Pause

However, I can't see in the documentation how to skip to another song/track? I can only see the destroy method?

Any guidance appreciated!

Stream Video

can we store stream video using this library