README.zh.md

BMPlayer

介绍

本项目是基于 AVPlayer 使用 Swift 封装的视频播放器，方便快速集成。

功能

• 支持横、竖屏切换，支持自动旋转屏幕
• 支持本地视频、网络视频播放
• 左侧 1/2 位置上下滑动调节屏幕亮度（模拟器调不了亮度，请在真机调试）
• 右侧 1/2 位置上下滑动调节音量（模拟器调不了音量，请在真机调试）
• 左右滑动调节播放进度
• 清晰度切换
• 镜像、慢放

要求

• iOS 8 +
• Xcode 7.3
• Swift 2.2

安装

CocoaPods

Swift3

确保使用最新版本cocoapods cocoapods 1.1.0.rc.2, 可以使用命令 sudo gem install cocoapods --pre 来升级.

target 'ProjectName' do
    use_frameworks!
    pod 'BMPlayer'
end

post_install do |installer|
    installer.pods_project.targets.each do |target|
        target.build_configurations.each do |configuration|
            configuration.build_settings['SWIFT_VERSION'] = "3.0"
            configuration.build_settings['ALWAYS_EMBED_SWIFT_STANDARD_LIBRARIES'] = 'NO'
        end
    end
end

Swift 2.2

use_frameworks!

pod 'BMPlayer', '~> 0.3.3'

Carthage

安装好 Carthage 后，将下列内容加入你项目的 Cartfile:

github "BrikerMan/BMPlayer"

最后，在 general panel 里 的 "Embedded Binaries" 项下点击 "Add Other..." 按钮，BMPlayer.framework 已经躺在了 ./Carthage/Build/iOS 目录里。

Demo

运行 Demo ，请下载后先在 Example 目录运行 pod install

使用 （支持IB和代码）

设置状态栏颜色

请在 info.plist 中增加 "View controller-based status bar appearance" 字段，并改为 NO

IB用法

直接拖 UIView 到 IB 上，宽高比为约束为 16:9 (优先级改为 750，比 1000 低就行)，代码部分只需要实现。更多细节请看Demo。

import BMPlayer

player.playWithURL(URL(string: url)!)

player.backBlock = { [unowned self] in
    self.navigationController?.popViewControllerAnimated(true)
}

代码布局（SnapKit）

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)
    // 注意此处，宽高比 16:9 优先级比 1000 低就行，在因为 iPhone 4S 宽高比不是 16：9
        make.height.equalTo(player.snp_width).multipliedBy(9.0/16.0).priority(750)
}
player.backBlock = { [unowned self] in
    let _ = self.navigationController?.popViewController(animated: true)
}

设置普通视频

// 若title为""，则不显示
player.playWithURL(URL(string: "http://baobab.wdjcdn.com/14571455324031.mp4")!, title: "风格互换：原来你我相爱")

多清晰度，带封面视频

let resource0 = BMPlayerItemDefinitionItem(url: URL(string: "http://baobab.wdjcdn.com/14570071502774.mp4")!, definitionName: "高清")
let resource1 = BMPlayerItemDefinitionItem(url: URL(string: "http://baobab.wdjcdn.com/1457007294968_5824_854x480.mp4")!, definitionName: "标清")

let item    = BMPlayerItem(title: "周末号外丨川普版权力的游戏",
resource: [resource0, resource1],
cover: "http://img.wdjimg.com/image/video/acdba01e52efe8082d7c33556cf61549_0_0.jpeg")

监听状态变化

具体用法请看 Example 项目

闭包方式

//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)")
}

协议方式

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)  { }
}

播放器自定义属性

需要在创建播放器前设定

// 是否打印日志，默认false
BMPlayerConf.allowLog = false
// 是否自动播放，默认true
BMPlayerConf.shouldAutoPlay = true
// 主体颜色，默认白色
BMPlayerConf.tintColor = UIColor.whiteColor()
// 顶部返回和标题显示选项，默认.Always，可选.HorizantalOnly、.None
BMPlayerConf.topBarShowInCase = .Always
// 显示慢放和镜像按钮
BMPlayerConf.slowAndMirror = true
// 加载效果，更多请见：https://github.com/ninjaprox/NVActivityIndicatorView
BMPlayerConf.loaderType  = NVActivityIndicatorType.BallRotateChase

进阶用法

• 自定义控制 UI
• 或者使用 BMPlayerLayer 并且自己定制控制 UI 和逻辑。

效果

参考：

本项目重度参考了 ZFPlayer，感谢 ZFPlayer 作者的支持和帮助。

联系我：

• 博客: https://eliyar.biz
• 邮箱: eliyar917@gmail.com

贡献者

• Albert Young
• tooodooo
• Ben Bahrenburg

欢迎提交 issue 和 PR，大门永远向所有人敞开。

License

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