Swiftpack.co -  nayanda1/Odeum as Swift Package
Swiftpack.co is a collection of thousands of indexed Swift packages. Search packages.
nayanda1/Odeum
Odeum is a simple iOS Video player library with basic control
.package(url: "https://github.com/nayanda1/Odeum.git", from: "1.2.4")

Odeum

Odeum is a simple iOS Video player library with basic control

build test Version License Platform

Example

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

Requirements

  • Swift 5.0 or higher
  • iOS 10.0 or higher

Installation

Cocoapods

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

pod 'Odeum'

Swift Package Manager from XCode

  • Add it using xcode menu File > Swift Package > Add Package Dependency
  • Add https://github.com/nayanda1/Odeum.git as Swift Package url
  • Set rules at version, with Up to Next Major option and put 1.2.0 as its version
  • Click next and wait

Swift Package Manager from Package.swift

Add as your target dependency in Package.swift

dependencies: [
    .package(url: "https://github.com/nayanda1/Odeum.git", .upToNextMajor(from: "1.2.0"))
]

Use it in your target as Odeum

 .target(
    name: "MyModule",
    dependencies: ["Odeum"]
)

Author

Nayanda Haberty, nayanda1@outlook.com

License

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

Usage

Using Odeum is very easy. You could see the sample project or just read this documentation.

Since odeum player is subclass of UIView. adding player is same like adding simple UIView:

var odeumPlayer = OdeumPlayerView()
view.addSubview(odeumPlayer)

Is up to you how you want it to framed, using NSLayoutConstraints or by manually framing it.

You could also add it using storyboard or XIB. Just use UIView and set its CustomClass to<img style="max-width:100%;" src="https://raw.github.com/nayanda1/Odeum/main/PlayerView`.

To play the player, just add url:

odeumPlayer.play(url: myURL)

there are methods to manipulate video playing in odeum:

  • func set(url: URL) to set url but not automatically play the video
  • func play() to play the video if video is ready to play
  • func play(url: URL) to set url and automatically play it if video is ready
  • func pause() to pause the video
  • func set(mute: Bool) to mute or unmute the video
  • func forward(by second: TimeInterval) -> Bool to forward a video by given TimeInterval
  • func replay(by second: TimeInterval) -> Bool to rewind a video by given TimeInterval
  • func goFullScreen() to go to full screen
  • func dismissFullScreen() to dismiss full screen
  • func removeVideo() to stop and remove video from video player

All those function will run automatically on the player control hover buttons

Delegate

You could observe event in the OdeumPlayerView by give them delegate:

public protocol OdeumPlayerViewDelegate: class {
    func odeumDidPlayVideo(_ player: OdeumPlayerView)
    func odeumDidPauseVideo(_ player: OdeumPlayerView)
    func odeumViewControllerToPresentFullScreen(_ player: OdeumPlayerView) -> UIViewController
    func odeumDidGoToFullScreen(_ player: OdeumPlayerView)
    func odeumDidDismissFullScreen(_ player: OdeumPlayerView)
    func odeumDidMuted(_ player: OdeumPlayerView)
    func odeumDidUnmuted(_ player: OdeumPlayerView)
    func odeum(_ player: OdeumPlayerView, forwardedBy interval: TimeInterval)
    func odeum(_ player: OdeumPlayerView, rewindedBy interval: TimeInterval)
    func odeumDidBuffering(_ player: OdeumPlayerView)
    func odeumDidFinishedBuffering(_ player: OdeumPlayerView)
    func odeum(_ player: OdeumPlayerView, progressingBy percent: Double)
}

All the methods are optionals

PlayerControl

If user tap the video player, it will show PlayerControlView which will control how the video will be played in OdeumPlayerView. You could also change the icon of the PlayerControlView:

odeumPlayer.playerControl.set(icon: myIcon, for: ReplayStep.fiveSecond)

the states are:

public enum PlayState {
    case played
    case paused
}

public enum AudioState {
    case mute
    case unmute
}

public enum ReplayStep {
    case fiveSecond
    case tenSecond
    case thirtySecond
}

public enum ForwardStep {
    case fiveSecond
    case tenSecond
    case thirtySecond
}

public enum FullScreenState {
    case fullScreen
    case minimize
}

To change the replay step and audio state time interval, you could assign it directly on playerControl:

odeumPlayer.playerControl.forwardStep = .thirtySecond
odeumPlayer.playerControl.replayStep = .thirtySecond

Contribute

You know how, just clone and do pull request

GitHub

link
Stars: 1
Last commit: 2 days 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.

Release Notes

Fix bundle for Cocoapods and SPM
13 weeks ago

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