CocoaPods Version Status Carthage compatible CocoaPods CocoaPods Platform Swift MIT License

SwiftVideoBackground is an easy to use Swift framework that provides the ability to play a video on any UIView. This provides a beautiful UI for login screens, or splash pages, as implemented by Spotify and many others.

  1. Requirements
  2. Integration
  3. Migration Guide
  4. Usage
  5. License
  6. Authors

Requirements

  • Swift 3+
  • iOS 8+

Integration

CocoaPods

You can use CocoaPods to install SwiftVideoBackground by adding it to your Podfile:

For Swift 4:

    pod 'SwiftVideoBackground', '~> 2.0.0'

For Swift 3:

    pod 'SwiftVideoBackground', '~> 0.06'

Carthage

You can use Carthage to install SwiftVideoBackground by adding it to your Cartfile:

github "dingwilson/SwiftVideoBackground"

Manually

To use this library in your project manually you may:

  1. for Projects, just drag VideoBackground.swift to the project tree
  2. for Workspaces, include the whole SwiftVideoBackground.xcodeproj

Migration Guide

Version 2.0.0 brings improvements and breaking changes. See the quick migration guide here.

Usage

Example

import UIKit
import VideoBackground

class MyViewController: UIViewController {
  private let videoBackground = VideoBackground()

  override func viewDidLoad() {
    super.viewDidLoad()

    videoBackground.play(view: view, videoName: "myvideo", videoType: "mp4")
  }
}

Documentation for Version 0.06 (Swift 3) can be found here.

Customization Options

play() has three additional optional parameters for customization:

  • isMuted: Bool - Indicates whether video is muted. Defaults to true.
  • alpha: CGFloat - Value between 0 and 1. The higher the value, the darker the video. Defaults to 0.
  • willLoopVideo: Bool - Indicates whether video should restart when finished. Defaults to true.

So for example:

videoBackground.play(view: view,
                     videoName: "myvideo",
                     videoType: "mp4",
                     isMuted: false,
                     alpha: 0.25,
                     willLoopVideo: true)

-> will play the video with the sound on, slightly darkened, and will continuously loop.

Any combination of the three can be included or left out.

Adding Videos To Your Project

You must properly add videos to your project in order to play them. To do this:

  1. Open your project navigator
  2. Select your target
  3. Select Build Phases
  4. Select Copy Bundle Resources
  5. Click + to add a video

add video to project

License

SwiftVideoBackground is released under an MIT License. See LICENSE for details.

Authors

Wilson Ding, Quan Vo

Copyright © 2016-present Wilson Ding.

Please provide attribution, it is greatly appreciated.