## BMPlayer
[](https://github.com/Carthage/Carthage)
[](http://cocoapods.org/pods/BMPlayer)
[](http://cocoapods.org/pods/BMPlayer)
[](http://cocoapods.org/pods/BMPlayer)
[](http://weibo.com/536445669)
[](https://app.fossa.io/projects/git%2Bgithub.com%2FBrikerMan%2FBMPlayer?ref=badge_shield)
A video player for iOS, based on AVPlayer, support the horizontal, vertical screen. support adjust volume, brightness and seek by slide, support subtitles.
[中文说明](https://github.com/BrikerMan/BMPlayer/blob/master/README.zh.md)
## Features
- [x] Support for horizontal and vertical play mode
- [x] Support play online URL and local file
- [x] Adjust brightness by slide vertical at left side of screen
- [x] Adjust volume by slide vertical at right side of screen
- [x] Slide horizontal to fast forward and rewind
- [x] Support multi-definition video
- [x] Custom playrate
- [x] Add Http header and other options to AVURLAsset
- [x] Easy to customize
- [x] Supporting show local and online subtitles
- [x] [Swift 5](https://developer.apple.com/swift/)
## Requirements
- iOS 10.0+
- Xcode 10.0+
- Swift 4+
## Supporting the project
**You can support the project by checking out our sponsor page. It takes only one click:**
This advert was placed by GitAds
## Installation
### CocoaPods
| Swift | podfile |
| --------- | ---------------------------- |
| Swift 5.0 | `pod 'BMPlayer', '~> 1.3.0'` |
| Swift 4.2 | `pod 'BMPlayer', '~> 1.2.0'` |
| Swift 4.0 | `pod 'BMPlayer', '~> 1.0.0'` |
| Swift 3.0 | `pod 'BMPlayer', '~> 0.9.1'` |
| Swift 2.2 | `pod 'BMPlayer', '~> 0.3.3'` |
**To test the experimental caching support with [VIMediaCache](https://github.com/vitoziv/VIMediaCache), use**
```swift
pod 'BMPlayer/CacheSupport', :git => 'https://github.com/BrikerMan/BMPlayer.git'
```
### Swift Pakage Manager
```swift
'https://github.com/BrikerMan/BMPlayer.git'
```
### Carthage
Add `BMPlayer` in your Cartfile.
```txt
github "BrikerMan/BMPlayer"
```
Run carthage to build the framework and drag the built BMPlayer.framework into your Xcode project.
### Demo
run `pod install` at `Example` folder before run the demo.
## Usage （Support IB and code）
### Set status bar color
Please add the `View controller-based status bar appearance` field in info.plist and change it to NO
### IB usage
Direct drag IB to UIView, the aspect ratio for the 16:9 constraint (priority to 750, lower than the 1000 line), the code section only needs to achieve. See more detail on the demo.
```swift
import BMPlayer
player.playWithURL(URL(string: url)!)
player.backBlock = { [unowned self] (isFullScreen) in
if isFullScreen == true { return }
let _ = self.navigationController?.popViewController(animated: true)
}
```
### Code implementation by [SnapKit](https://github.com/SnapKit/SnapKit)
```swift
import BMPlayer
player = BMPlayer()
view.addSubview(player)
player.snp.makeConstraints { (make) in
make.top.equalTo(self.view).offset(20)
make.left.right.equalTo(self.view)
// Note here, the aspect ratio 16:9 priority is lower than 1000 on the line, because the 4S iPhone aspect ratio is not 16:9
make.height.equalTo(player.snp.width).multipliedBy(9.0/16.0).priority(750)
}
// Back button event
player.backBlock = { [unowned self] (isFullScreen) in
if isFullScreen == true { return }
let _ = self.navigationController?.popViewController(animated: true)
}
```
### Set video url
```swift
let asset = BMPlayerResource(url: URL(string: "http://baobab.wdjcdn.com/14525705791193.mp4")!,
name: "风格互换：原来你我相爱")
player.setVideo(resource: asset)
```
### multi-definition video with cover
```swift
let res0 = BMPlayerResourceDefinition(url: URL(string: "http://baobab.wdjcdn.com/1457162012752491010143.mp4")!,
definition: "高清")
let res1 = BMPlayerResourceDefinition(url: URL(string: "http://baobab.wdjcdn.com/1457162012752491010143.mp4")!,
definition: "标清")
let asset = BMPlayerResource(name: "周末号外丨中国第一高楼",
definitions: [res0, res1],
cover: URL(string: "http://img.wdjimg.com/image/video/447f973848167ee5e44b67c8d4df9839_0_0.jpeg"))
player.setVideo(resource: asset)
```
### Add HTTP header for request
```swift
let header = ["User-Agent":"BMPlayer"]
let options = ["AVURLAssetHTTPHeaderFieldsKey":header]
let definition = BMPlayerResourceDefinition(url: URL(string: "http://baobab.wdjcdn.com/1457162012752491010143.mp4")!,
definition: "高清",
options: options)
let asset = BMPlayerResource(name: "Video Name",
definitions: [definition])
```
### Listening to player state changes
See more detail from the Example project
#### Block
```swift
//Listen to when the player is playing or stopped
player?.playStateDidChange = { (isPlaying: Bool) in
print("playStateDidChange \(isPlaying)")
}
//Listen to when the play time changes
player?.playTimeDidChange = { (currentTime: TimeInterval, totalTime: TimeInterval) in
print("playTimeDidChange currentTime: \(currentTime) totalTime: \(totalTime)")
}
```
#### Delegate
```swift
protocol BMPlayerDelegate {
func bmPlayer(player: BMPlayer ,playerStateDidChange state: BMPlayerState) { }
func bmPlayer(player: BMPlayer ,loadedTimeDidChange loadedDuration: TimeInterval, totalDuration: TimeInterval) { }
func bmPlayer(player: BMPlayer ,playTimeDidChange currentTime : TimeInterval, totalTime: TimeInterval) { }
func bmPlayer(player: BMPlayer ,playerIsPlaying playing: Bool) { }
}
```
## Customize player
Needs to change before the player alloc.
```swift
// should print log, default false
BMPlayerConf.allowLog = false
// should auto play, default true
BMPlayerConf.shouldAutoPlay = true
// main tint color, default whiteColor
BMPlayerConf.tintColor = UIColor.whiteColor()
// options to show header view (which include the back button, title and definition change button) , default .Always，options: .Always, .HorizantalOnly and .None
BMPlayerConf.topBarShowInCase = .Always
// loader type, see detail：https://github.com/ninjaprox/NVActivityIndicatorView
BMPlayerConf.loaderType = NVActivityIndicatorType.BallRotateChase
// enable setting the brightness by touch gesture in the player
BMPlayerConf.enableBrightnessGestures = true
// enable setting the volume by touch gesture in the player
BMPlayerConf.enableVolumeGestures = true
// enable setting the playtime by touch gesture in the player
BMPlayerConf.enablePlaytimeGestures = true
```
## Advanced Customize
- Subclass `BMPlayerControlView` to create your personal control UI, check the Example.
- Use the `BMPlayerLayer` with your own player control view.
## Demonstration
## Reference:
This project heavily reference the Objective-C version of this project [ZFPlayer](https://github.com/renzifeng/ZFPlayer), thanks for the generous help of ZFPlayer's author.
## Contact me：
- Blog: https://eliyar.biz
- Email: eliyar917@gmail.com
## Contributors
- [Albert Young](https://github.com/cedared)
- [tooodooo](https://github.com/tooodooo)
- [Ben Bahrenburg](https://github.com/benbahrenburg)
- [MangoMade](https://github.com/MangoMade)
- [iblacksun](https://github.com/iblacksun)
You are welcome to fork and submit pull requests.
## License
BMPlayer is available under the MIT license. See the LICENSE file for more info.
[](https://app.fossa.io/projects/git%2Bgithub.com%2FBrikerMan%2FBMPlayer?ref=badge_large)