velociplayer's Introduction

VelociPlayer

Welcome to VelociPlayer, Rapptr Labs' iOS audio and video player toolkit.

VelociPlayer is a subclass of AVPlayer which enables rapid development of audio and video players.

Integration Example

This example uses a SwiftUI view:

public struct AudioPlayerView: View {
    @ObservedObject public var player: VelociPlayer

    public var body: some View {
        VStack {
            // Play/Pause Button
            Button {
                player.togglePlayback()
            } label: {
                Image(
                    systemName: player.isPaused ?
                        "play.circle.fill" : 
                        "pause.circle.fill"
                )
            }
            
            HStack {
                Text("\(player.time.seconds)")
                
                Spacer()
                
                Text("\(player.duration.seconds)")
            }
        }
    }
}

You can initialize an instance of VelociPlayer with the URL to your content like so:

let player = VelociPlayer(
    autoPlay: true,
    mediaURL: URL(string: "...")
)

velociplayer's People

Contributors

Stargazers

Watchers

velociplayer's Issues

No callback for setting mediaURL

I would like to set a new mediaURL and then immediately seek to a time based on the new media's duration. However, the duration sets asynchronously (within the didSet of mediaURL) and therefore seeking doesn't work immediately.

Attempt 1:

        // Fails bc duration == 0
        self.player.mediaURL = url
        let duration = player.duration.seconds
        let seconds = 0.3 * duration
        self.player.seek(to: VPTime(seconds: seconds, preferredTimescale: 1))
        self.player.play()

Attempt 2:

        // Fails within seek(toPercent:) function bc duration == 0
        self.player.mediaURL = url
        self.player.seek(toPercent: 0.3)
        self.player.play()

One idea would be to not set mediaURL directly and instead have a function similar to the initializer.

func updateMedia(autoPlay: Bool, mediaURL: URL?, startTime: VPTime?)

Otherwise, maybe some sort of callback when setting new mediaURL to signify "didFinishSetting"

Seeking without ever pressing play

If seeking, but user never clicked play, player will seek but the player's progress will not publish the updated value because startObservingPlayer() was never called

Suggestion: Add ability to start playback at a specific point in time

AVAudioSession unintentionally causes other playbacks to stop

Updates in #29 now call setAVCategory before player is needed/used and the default settings (setCategory, setActive) cause other audio to play playing. (ie. Spotify automatically stops as soon as there's a reference to VelociPlayer).

            try? AVAudioSession.sharedInstance().setCategory(audioCategory, mode: audioMode)
            try? AVAudioSession.sharedInstance().setActive(true, options: .notifyOthersOnDeactivation)

internal func beginPlayerObservationIfNeeded() {
        if timeObserver == nil {
            startObservingPlayer()
            setAVCategory()
        }
    }