Skip to content

Latest commit

 

History

History
295 lines (223 loc) · 7.84 KB

README.zh.md

File metadata and controls

295 lines (223 loc) · 7.84 KB
Raw

ZFPlayer

基于AVPlayer，支持竖屏、横屏（横屏可锁定屏幕方向），上下滑动调节音量、屏幕亮度，左右滑动调节播放进度

ZFPlayer剖析  哪些app使用ZFPlayer

特性

  • 支持横、竖屏切换，在横屏模式下可以锁定屏幕方向
  • 支持本地视频、网络视频播放
  • 支持在TableviewCell播放视频
  • 左侧1/2位置上下滑动调节屏幕亮度（模拟器调不了亮度，请在真机调试）
  • 右侧1/2位置上下滑动调节音量（模拟器调不了音量，请在真机调试）
  • 左右滑动调节播放进度
  • 全屏状态下拖动slider控制进度，显示视频的预览图
  • 断点下载功能
  • 切换视频分辨率

要求

  • iOS 8+
  • Xcode 8+

统计

哪些APP使用ZFPlayer，并上架AppStore，请告诉我，帮助我统计。

组件

安装

CocoaPods

pod 'ZFPlayer'

Then, run the following command:

$ pod install

使用 （支持IB和代码）

设置状态栏颜色

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

IB用法

直接拖UIView到IB上，宽高比为约束为16：9(优先级改为750，比1000低就行)，代码部分只需要实现

self.playerView.videoURL = self.videoURL;
// 设置代理
self.playerView.delegate = self;

ZFPlayerDelegate

/** 返回按钮事件 */
- (void)zf_playerBackAction;
/** 下载视频 */
- (void)zf_playerDownload:(NSString *)url;
代码实现（Masonry）用法
self.playerView = [[ZFPlayerView alloc] init];
[self.view addSubview:self.playerView];
[self.playerView mas_makeConstraints:^(MASConstraintMaker *make) {
 	make.top.equalTo(self.view).offset(20);
 	make.left.right.equalTo(self.view);
	// 注意此处，宽高比16：9优先级比1000低就行，在因为iPhone 4S宽高比不是16：9
	make.height.equalTo(self.playerView.mas_width).multipliedBy(9.0f/16.0f).with.priority(750);
}];

// 指定控制层（可自定义）
ZFPlayerControlView *controlView = [[ZFPlayerControlView alloc] init];
self.playerView.controlView = controlView;

ZFPlayerModel *playerModel = [[ZFPlayerModel alloc]init];
playerModel.videoUrl = @"...";
// 设置视频model
self.playerView.playerModel = playerModel;
// 设置代理
self.playerView.delegate = self;
设置视频的填充模式
 // 设置视频的填充模式，内部设置默认（ZFPlayerLayerGravityResizeAspect：等比例填充，直到一个维度到达区域边界）
 self.playerView.playerLayerGravity = ZFPlayerLayerGravityResizeAspect;
是否有断点下载功能
 // 下载功能，如需要此功能设置这里
 self.playerView.hasDownload = YES;
从xx秒开始播放视频
// 从xx秒开始播放视频
self.playerView.seekTime = 15;
是否自动播放，默认不自动播放
// 是否自动播放，默认不自动播放
[self.playerView autoPlayTheVideo];
设置播放前的占位图
// 设置播放前的占位图
ZFPlayerModel *playerModel = [[ZFPlayerModel alloc]init];
playerModel.placeholderImage = [UIImage imageNamed: @"..."];
self.playerView.playerModel = playerModel;
自定义控制层

self.playerView.controlView = 自定义的View;

自定义view你需要实现以下方法，直接在.m中实现即可，可参考ZFPlayerControlView.m

/** 
 显示控制层
 */
- (void)zf_playerShowControlView;
/** 
 隐藏控制层
*/
- (void)zf_playerHideControlView;

/** 
 重置ControlView 
 */
- (void)zf_playerResetControlView;

/** 
 切换分辨率时重置ControlView 
 */
- (void)zf_playerResetControlViewForResolution;

/** 
 取消自动隐藏控制层view 
 */
- (void)zf_playerCancelAutoFadeOutControlView;

/** 
 播放完了 
 */
- (void)zf_playerPlayEnd;

/** 
 是否有下载功能 
 */
- (void)zf_playerHasDownloadFunction:(BOOL)sender;

/**
 是否有切换分辨率功能
 @param resolutionArray 分辨率名称的数组
 */
- (void)zf_playerResolutionArray:(NSArray *)resolutionArray;

/** 
 播放按钮状态 (播放、暂停状态)
 */
- (void)zf_playerPlayBtnState:(BOOL)state;

/** 
 锁定屏幕方向按钮状态 
 */
- (void)zf_playerLockBtnState:(BOOL)state;

/**
 下载按钮状态
 */
- (void)zf_playerDownloadBtnState:(BOOL)state;

/** 
 设置标题 
 */
- (void)zf_playerSetTitle:(NSString *)title;

/** 
 加载的菊花
 */
- (void)zf_playerActivity:(BOOL)animated;

/**
 设置预览图

 @param draggedTime 拖拽的时长
 @param image       预览图
 */
- (void)zf_playerDraggedTime:(NSInteger)draggedTime sliderImage:(UIImage *)image;

/**
 拖拽快进 快退

 @param draggedTime 拖拽的时长
 @param totalTime   视频总时长
 @param forawrd     是否是快进
 @param preview     是否有预览图
 */
- (void)zf_playerDraggedTime:(NSInteger)draggedTime totalTime:(NSInteger)totalTime isForward:(BOOL)forawrd hasPreview:(BOOL)preview;

/** 
 滑动调整进度结束结束 
 */
- (void)zf_playerDraggedEnd;

/**
 正常播放

 @param currentTime 当前播放时长
 @param totalTime   视频总时长
 @param value       slider的value(0.0~1.0)
 */
- (void)zf_playerCurrentTime:(NSInteger)currentTime totalTime:(NSInteger)totalTime sliderValue:(CGFloat)value;

/** 
 progress显示缓冲进度 
 */
- (void)zf_playerSetProgress:(CGFloat)progress;

/** 
 视频加载失败 
 */
- (void)zf_playerItemStatusFailed:(NSError *)error;

/**
 小屏播放
 */
- (void)zf_playerBottomShrinkPlay;

/**
 在cell播放
 */
- (void)zf_playerCellPlay;

图片效果演示

图片效果演示

声音调节演示

亮度调节演示

进度调节预览图

参考链接：

Swift版Player：

请移步 BMPlayer，感谢 BMPlayer 作者的开源。

Swift版知乎日报：

本人最近编写的 知乎日报Swift。

联系我

License

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