Swiftpack.co - eroscai/SZAVPlayer as Swift Package

Swiftpack.co is a collection of thousands of indexed Swift packages. Search packages.
SZAVPlayer is a lightweight audio/video player library, based on AVPlayer and AVAssetResourceLoaderDelegate, pure-Swift. Support cache and video image output.
.package(url: "https://github.com/eroscai/SZAVPlayer.git", from: "1.3.2")


Version Carthage compatible SPM supported License Platform


SZAVPlayer is a lightweight audio/video player library, based on AVPlayer, pure-Swift. Support cache and video image output.


  • ☑ Encapsulate the state changes of AVPlayer and AVPlayerItem and output them uniformly, greatly reducing the implementation cost of audio/video play.
  • ☑ Achieved full control of AVPlayer data loading, based on AVAssetResourceLoaderDelegate. Through the Range request and corresponding cache, it can respond to player's requests ASAP. It also can play the cached audio/video normally in the weak network and no network enviroment.
  • ☑ Support video image output, can be drawn to multiple views at the same time.
  • ☑ Load AVAsset asynchronously to not blocking the main thread.
  • ☑ Support setting cache size munually and also support cleaning.

Main Flow

Main Flow


If you find that always play failed in the simulator, try exit simulator completely and restart again. This is kind of simulator's bug.


  1. Create player and set delegate.

    let player = SZAVPlayer()
    player.delegate = self
    audioPlayer = player
  2. Setup player with url.

    // uniqueID is to identify wether they are the same audio. If set to nil will use urlStr to create one.
    let config = SZAVPlayerConfig(urlStr: audio.url, uniqueID: nil)
    audioPlayer.setupPlayer(config: config)


    // If you want play video, pass an additional parameter `isVideo`.
    let config = SZAVPlayerConfig(urlStr: video.url, uniqueID: nil, isVideo: true, isVideoOutputEnabled: true/false)
    videoPlayer.setupPlayer(config: config)
  3. Implement SZAVPlayerDelegate.

    extension AudioViewController: SZAVPlayerDelegate {
        func avplayer(_ avplayer: SZAVPlayer, refreshed currentTime: Float64, loadedTime: Float64, totalTime: Float64) {
            progressView.update(currentTime: currentTime, totalTime: totalTime)
        func avplayer(_ avplayer: SZAVPlayer, didChanged status: SZAVPlayerStatus) {
            switch status {
            case .readyToPlay:
                SZLogInfo("ready to play")
                if playerStatus == .playing {
            case .playEnd:
                SZLogInfo("play end")
            case .loading:
            case .loadingFailed:
                SZLogInfo("loading failed")
            case .bufferBegin:
                SZLogInfo("buffer begin")
            case .bufferEnd:
                SZLogInfo("buffer end")
                if playerStatus == .stalled {
            case .playbackStalled:
                SZLogInfo("playback stalled")
                playerStatus = .stalled
        func avplayer(_ avplayer: SZAVPlayer, didReceived remoteCommand: SZAVPlayerRemoteCommand) -> Bool {
            return false
  4. Replace new audio.

    // The setupPlayer function will automatically determine if it has been setup before. 
    // If it is, it will directly call the replacePalyerItem function to replace the new audio.
    audioPlayer.setupPlayer(config: config)


    // or just use this function.
    audioPlayer.replace(urlStr: audio.url, uniqueID: nil)

    these two functions have the same effect.

  5. Enable video image output.

    • Set isVideoOutputEnabled to true.
    let config = SZAVPlayerConfig(urlStr: video.url, uniqueID: nil, isVideo: true, isVideoOutputEnabled: true)
    videoPlayer.setupPlayer(config: config)
    • Implement avplayer delegate function.
    func avplayer(_ avplayer: SZAVPlayer, didOutput videoImage: CGImage) {
        videoOutputView1.layer.contents = videoImage
    • Call removeVideoOutput function when ready to release the player.
  6. Seek player to time.

    audioPlayer.seekPlayerToTime(time: currentTime, completion: nil)
  7. Set max cache size.

    // Unit: MB, if reached the max size, it will automatically trim the cache.
    SZAVPlayerCache.shared.setup(maxCacheSize: 100)
  8. Clean all cache.



The Example project has implemented a complete play example, including play/pause/previous/next/seekToTime/cleanCache, etc.

To run the example project, clone the repo, and run pod install from the Example directory first.


  • iOS 10.0+
  • Swift 5.0+



SZAVPlayer is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod 'SZAVPlayer'


Carthage is a decentralized dependency manager that builds your dependencies and provides you with binary frameworks. To integrate SZAVPlayer into your Xcode project using Carthage, specify it in your Cartfile:

github "eroscai/SZAVPlayer" ~> 1.1.1

Swift Package Manager

From Xcode 11, you can use Swift Package Manager to add SZAVPlayer to your project.

  • Select File > Swift Packages > Add Package Dependency. Enter https://github.com/eroscai/SZAVPlayer.git in the "Choose Package Repository" dialog.
  • Add CoreServices.framework and AVFoundation.framework to your project if not added before. (If anyone knows how to do this automatically, please tell me).


eroscai, csz0102@gmail.com


SZAVPlayer is available under the MIT license. See the LICENSE file for more info.


Stars: 105
Last commit: 5 weeks ago

Ad: Job Offers

iOS Software Engineer @ Perry Street Software
Perry Street Software is Jack’d and SCRUFF. We are two of the world’s largest gay, bi, trans and queer social dating apps on iOS and Android. Our brands reach more than 20 million members worldwide so members can connect, meet and express themselves on a platform that prioritizes privacy and security. We invest heavily into SwiftUI and using Swift Packages to modularize the codebase.

Submit a free job ad (while I'm testing this). The analytics numbers for this website are here.

Release Notes

5 weeks ago
  • Add delete single cache item by uniqueID

Swiftpack is being maintained by Petr Pavlik | @ptrpavlik | @swiftpackco | API | Analytics