4.6 自己动手撸一个 SJControlLayerAppearManager, 替换作者原始实现
同样的, 协议 "SJControlLayerAppearManager" 定义了一系列的操作, 只要实现了这些协议方法的对象, 就可以管理控制层的显示和隐藏.
```Objective-C _player.controlLayerAppearManager = Your controlLayerAppearManager; ``` ___5. 设备亮度和音量
设备亮度和音量的调整, 此部分的内容由 "id <SJDeviceVolumeAndBrightnessManager> deviceVolumeAndBrightnessManager" 提供支持.
5.1 调整设备亮度
```Objective-C
// 0 到 1
_player.deviceVolumeAndBrightnessManager.brightness = 1.0;
```
5.2 调整设备声音
```Objective-C
// 0 到 1
_player.deviceVolumeAndBrightnessManager.volume = 1.0;
```
5.3 监听状态改变🔥
```Objective-C
///
/// 观察者
///
@property (nonatomic, strong, readonly) id deviceVolumeAndBrightnessObserver;
```
5.4 禁止播放器设置
```Objective-C
_player.disableBrightnessSetting = YES;
_player.disableVolumeSetting = YES;
```
5.5 自己动手撸一个 SJDeviceVolumeAndBrightnessManager, 替换作者原始实现
当需要对设备音量视图进行自定义时, 可以自己动手撸一个 SJDeviceVolumeAndBrightnessManager.
```Objective-C
_player.deviceVolumeAndBrightnessManager = Your deviceVolumeAndBrightnessManager;
```
___
8. 镜像翻转
此部分内容由 id<SJFlipTransitionManager> flipTransitionManager 提供支持
目前镜像翻转只写了 水平翻转, 未来可能会加入更多的翻转类型.
```Objective-C
typedef enum : NSUInteger {
SJViewFlipTransition_Identity,
SJViewFlipTransition_Horizontally, // 水平翻转
} SJViewFlipTransition;
```
8.1 翻转和恢复
```Objective-C
/// 当前的翻转类型
_player.flipTransition
/// 翻转相关方法
[_player setFlipTransition:SJViewFlipTransition_Horizontally];
[_player setFlipTransition:SJViewFlipTransition_Horizontally animated:YES];
[_player setFlipTransition:SJViewFlipTransition_Identity animated:YES completionHandler:^(__kindof SJBaseVideoPlayer * _Nonnull player) {
/// ...
}];
```
8.2 监听状态改变🔥
```Objective-C
///
/// 观察者
///
/// 可以如下设置block, 来监听某个状态的改变
///
/// player.flipTransitionObserver.flipTransitionDidStartExeBlock = ...;
/// player.flipTransitionObserver.flipTransitionDidStopExeBlock = ...;
///
@property (nonatomic, strong, readonly) id flipTransitionObserver;
```
8.3 自己动手撸一个 SJFlipTransitionManager, 替换作者原始实现
该部分管理类的协议定义在 SJFlipTransitionManagerProtocol 中, 实现该协议的任何对象, 均可赋值给播放器, 替换原始实现.
___
9. 网络状态
此部分内容由 id<SJReachability> reachability 提供支持
默认的 reachability 是个单例, 在App生命周期中, 仅创建一次. 因此每个播放器对象持有的 reachability 都是相同的.
9.1 当前的网络状态
```Objective-C
@property (nonatomic, readonly) SJNetworkStatus networkStatus;
```
9.2 监听状态改变🔥
```Objective-C
///
/// 观察者
///
@property (nonatomic, strong, readonly) id reachabilityObserver;
```
9.3 自己动手撸一个 SJReachability, 替换作者原始实现
该部分管理类的协议定义在 SJNetworkStatus 中, 实现该协议的任何对象, 均可赋值给播放器, 替换原始实现.
___
10. 手势
此部分内容由 id<SJPlayerGestureControl> gestureControl 提供支持
播放器默认存在四种手势, 每个手势触发的回调均定义在 SJPlayerGestureControl 中, 当想改变某个手势的处理时, 可以直接修改对应手势触发的 block 即可.
具体请看以下部分.
10.1 单击手势
当用户单击播放器时, 播放器会调用 [显示或隐藏控制层的操作](#4)
以下为默认实现:
```Objective-C
__weak typeof(self) _self = self;
_gestureControl.singleTapHandler = ^(id _Nonnull control, CGPoint location) {
__strong typeof(_self) self = _self;
if ( !self ) return ;
/// 让控制层显示或隐藏
[self.controlLayerAppearManager switchAppearState];
};
```
10.2 双击手势
双击会触发暂停或播放的操作
```Objective-C
__weak typeof(self) _self = self;
_gestureControl.doubleTapHandler = ^(id _Nonnull control, CGPoint location) {
__strong typeof(_self) self = _self;
if ( !self ) return ;
if ( [self playStatus_isPlaying] )
[self pause];
else
[self play];
};
```
10.3 移动手势
- 垂直滑动时, 默认情况下如果在屏幕左边, 则会触发调整亮度的操作, 并显示亮度提示视图. 如果在屏幕右边, 则会触发调整声音的操作, 并显示系统音量提示视图
- 水平滑动时, 会触发控制层相应的代理方法
```Objective-C
__weak typeof(self) _self = self;
_gestureControl.panHandler = ^(id _Nonnull control, SJPanGestureTriggeredPosition position, SJPanGestureMovingDirection direction, SJPanGestureRecognizerState state, CGPoint translate) {
__strong typeof(_self) self = _self;
if ( !self ) return ;
/// ....
};
```
10.4 捏合手势
当用户做放大或收缩触发该手势时, 会设置播放器显示模式`Aspect`或`AspectFill`.
```Objective-C
__weak typeof(self) _self = self;
_gestureControl.pinchHandler = ^(id _Nonnull control, CGFloat scale) {
__strong typeof(_self) self = _self;
if ( !self ) return ;
self.playbackController.videoGravity = scale > 1 ?AVLayerVideoGravityResizeAspectFill:AVLayerVideoGravityResizeAspect;
};
```
10.5 设置支持的手势
```Objective-C
_player.gestureControl.supportedGestureTypes = SJPlayerGestureTypeMask_Default
typedef enum : NSUInteger {
SJPlayerGestureTypeMask_None,
SJPlayerGestureTypeMask_SingleTap = 1 << 0,
SJPlayerGestureTypeMask_DoubleTap = 1 << 1,
SJPlayerGestureTypeMask_Pan_H = 1 << 2, // 水平方向
SJPlayerGestureTypeMask_Pan_V = 1 << 3, // 垂直方向
SJPlayerGestureTypeMask_Pinch = 1 << 4,
SJPlayerGestureTypeMask_LongPress = 1 << 5,
SJPlayerGestureTypeMask_Pan = SJPlayerGestureTypeMask_Pan_H | SJPlayerGestureTypeMask_Pan_V,
SJPlayerGestureTypeMask_Default = SJPlayerGestureTypeMask_SingleTap | SJPlayerGestureTypeMask_DoubleTap | SJPlayerGestureTypeMask_Pan | SJPlayerGestureTypeMask_Pinch,
SJPlayerGestureTypeMask_All = SJPlayerGestureTypeMask_Default | SJPlayerGestureTypeMask_LongPress,
} SJPlayerGestureTypeMask;
```
10.6 自定义某个手势的处理
```Objective-C
/// 例如 替换单击手势的处理
__weak typeof(self) _self = self;
_player.gestureControl.singleTapHandler = ^(id _Nonnull control, CGPoint location) {
__strong typeof(_self) self = _self;
if ( !self ) return ;
/// .....你的处理
};
```
___
11. 占位图
资源在初始化时, 由于暂时没有画面可以呈现, 会出现短暂的黑屏. 在此期间, 建议大家设置一下占位图.
11.1 设置本地占位图
```Objective-C
_player.presentView.placeholderImageView.image = [UIImage imageNamed:@"..."];
```
11.2 设置网络占位图
```Objective-C
[_player.presentView.placeholderImageView sd_setImageWithURL:URL placeholderImage:img];
```
11.3 是否隐藏占位图 - 播放器准备好显示时
```Objective-C
/// 播放器准备好显示时, 是否隐藏占位图
/// - 默认为YES
@property (nonatomic) BOOL hiddenPlaceholderImageViewWhenPlayerIsReadyForDisplay;
```
___
12. 显示提示文本
目前仅支持 NSAttributedString.
12.1 显示管理类
```Objective-C
///
/// 中心弹出文本提示
///
/// 了解更多请前往协议头文件查看
///
@property (nonatomic, strong, null_resettable) id prompt;
///
/// 左下角弹出提示
///
/// 了解更多请前往协议头文件查看
///
@property (nonatomic, strong, null_resettable) id popPromptController;
```
12.2 配置提示文本
```Objective-C
_player.prompt.backgroundColor = ...;
_player.prompt.contentInset = ...;
```
___
13. 一些固定代码
接入播放器的 ViewController 中, 会写一些固定的代码, 我将这些固定代码都封装在了以下方法中.
在适当的时候直接调用即可, 以下为内部实现:
13.4 - (BOOL)vc_prefersStatusBarHidden;
状态栏是否可以隐藏
实现如下:
```Objective-C
- (BOOL)vc_prefersStatusBarHidden {
if ( _tmpShowStatusBar ) return NO; // 临时显示
if ( _tmpHiddenStatusBar ) return YES; // 临时隐藏
if ( self.lockedScreen ) return YES; // 锁屏时, 不显示
if ( self.rotationManager.isTransitioning ) { // 旋转时, 不显示
if ( !self.disabledControlLayerAppearManager && self.isControlLayerAppeared ) return NO;
return YES;
}
// 全屏播放时, 使状态栏根据控制层显示或隐藏
if ( self.isFullScreen ) return !self.isControlLayerAppeared;
return NO;
}
```
13.5 - (UIStatusBarStyle)vc_preferredStatusBarStyle;
状态栏显示白色还是黑色
实现如下:
```Objective-C
- (UIStatusBarStyle)vc_preferredStatusBarStyle {
// 全屏播放时, 使状态栏变成白色
if ( self.isFullScreen || self.fitOnScreen ) return UIStatusBarStyleLightContent;
return UIStatusBarStyleDefault;
}
```
13.6 - 临时显示状态栏
有时候, 可能会希望临时显示状态栏, 例如全屏转回小屏时, 旋转之前, 需要将状态栏显示.
```Objective-C
[_player needShowStatusBar];
```
13.7 - 临时隐藏状态栏
有时候, 可能会希望临时隐藏状态栏, 例如某个播放器控制层不需要显示状态栏.
```Objective-C
[_player needHiddenStatusBar];
```
___
14. 截屏
14.1 当前时间截图
```Objective-C
UIImage *img = [_player screenshot];
```
14.2 指定时间截图
```Objective-C
- (void)screenshotWithTime:(NSTimeInterval)secs
completion:(void(^)(__kindof SJBaseVideoPlayer *videoPlayer, UIImage * __nullable image, NSError *__nullable error))block;
/// 可以通过 _player.playbackController.presentationSize 来获取当前视频宽高
- (void)screenshotWithTime:(NSTimeInterval)secs
size:(CGSize)size
completion:(void(^)(__kindof SJBaseVideoPlayer *videoPlayer, UIImage * __nullable image, NSError *__nullable error))block;
```
15. 导出视频或GIF
15.1 导出视频
```Objective-C
- (void)exportWithBeginTime:(NSTimeInterval)beginTime
duration:(NSTimeInterval)duration
presetName:(nullable NSString *)presetName
progress:(void(^)(__kindof SJBaseVideoPlayer *videoPlayer, float progress))progressBlock
completion:(void(^)(__kindof SJBaseVideoPlayer *videoPlayer, NSURL *fileURL, UIImage *thumbnailImage))completion
failure:(void(^)(__kindof SJBaseVideoPlayer *videoPlayer, NSError *error))failure;
```
15.2 导出GIF
```Objective-C
- (void)generateGIFWithBeginTime:(NSTimeInterval)beginTime
duration:(NSTimeInterval)duration
progress:(void(^)(__kindof SJBaseVideoPlayer *videoPlayer, float progress))progressBlock
completion:(void(^)(__kindof SJBaseVideoPlayer *videoPlayer, UIImage *imageGIF, UIImage *thumbnailImage, NSURL *filePath))completion
failure:(void(^)(__kindof SJBaseVideoPlayer *videoPlayer, NSError *error))failure;
```
15.3 取消操作
```Objective-C
/// 取消导出操作
/// 播放器 dealloc 时, 会调用一次
- (void)cancelExportOperation;
/// 取消GIF操作
/// 播放器 dealloc 时, 会调用一次
- (void)cancelGenerateGIFOperation;
```
16. 滚动相关
此部分的内容由 SJPlayModelPropertiesObserver 提供支持.
16.1 是否在 UICollectionView 或者 UITableView 中播放
```Objective-C
/// 是否是在 UICollectionView 或者 UITableView 中播放
_player.isPlayOnScrollView
```
16.2 是否已显示
```Objective-C
///
/// 播放器视图是否显示
///
/// Whether the player is appeared when playing on scrollView. Because scrollview may be scrolled.
///
@property (nonatomic, readonly) BOOL isScrollAppeared;
```
16.3 播放器视图将要滚动显示和消失的回调
```Objective-C
@property (nonatomic, copy, nullable) void(^playerViewWillAppearExeBlock)(__kindof SJBaseVideoPlayer *videoPlayer);
@property (nonatomic, copy, nullable) void(^playerViewWillDisappearExeBlock)(__kindof SJBaseVideoPlayer *videoPlayer);
```
16.4 滚动出去后, 是否暂停
```Objective-C
///
/// 滚动出去后, 是否暂停. 默认为YES
///
/// - default value is YES.
///
@property (nonatomic) BOOL pauseWhenScrollDisappeared;
```
16.5 滚动进入时, 是否恢复播放
```Objective-C
///
/// 滚动进入时, 是否恢复播放. 默认为YES
///
/// - default values is YES.
///
@property (nonatomic) BOOL resumePlaybackWhenScrollAppeared;
```
16.6 滚动出去后, 是否隐藏播放器视图
```Objective-C
///
/// 滚动出去后, 是否隐藏播放器视图. 默认为YES
///
/// - default value is YES.
///
@property (nonatomic) BOOL hiddenViewWhenScrollDisappeared;
```
17. 自动播放 - 在 UICollectionView 或者 UITableView 中
目前支持在 UICollectionViewCell 和 UITableViewCell 中自动播放.
使用之前, 请导入头文件 `#import "UIScrollView+ListViewAutoplaySJAdd.h"`
17.1 开启
```Objective-C
/// 配置列表自动播放
[_tableView sj_enableAutoplayWithConfig:[SJPlayerAutoplayConfig configWithPlayerSuperviewTag:101 autoplayDelegate:self]];
/// Delegate method
- (void)sj_playerNeedPlayNewAssetAtIndexPath:(NSIndexPath *)indexPath {
}
```
17.2 配置
```Objective-C
typedef NS_ENUM(NSUInteger, SJAutoplayScrollAnimationType) {
SJAutoplayScrollAnimationTypeNone,
SJAutoplayScrollAnimationTypeTop,
SJAutoplayScrollAnimationTypeMiddle,
};
@interface SJPlayerAutoplayConfig : NSObject
+ (instancetype)configWithPlayerSuperviewTag:(NSInteger)playerSuperviewTag
autoplayDelegate:(id)autoplayDelegate;
/// 滚动的动画类型
/// default is .Middle;
@property (nonatomic) SJAutoplayScrollAnimationType animationType;
@property (nonatomic, readonly) NSInteger playerSuperviewTag;
@property (nonatomic, weak, nullable, readonly) id autoplayDelegate;
@end
@protocol SJPlayerAutoplayDelegate
- (void)sj_playerNeedPlayNewAssetAtIndexPath:(NSIndexPath *)indexPath;
@end
```
17.3 关闭
```Objective-C
[_tableView sj_disenableAutoplay];
```
17.4 主动调用播放下一个资源
```Objective-C
[_tableView sj_needPlayNextAsset];
```
18. 对控制层上面的Item的操作
18.1 添加
```Objective-C
SJEdgeControlButtonItem *item = [[SJEdgeControlButtonItem alloc] initWithImage:[UIImage imageNamed:@"test"] target:self action:@selector(test) tag:SJTestImageItemTag];
[_player.defaultEdgeControlLayer.topAdapter addItem:item];
[_player.defaultEdgeControlLayer.topAdapter reload];
```
18.2 删除
```Objective-C
[_player.defaultEdgeControlLayer.bottomAdapter removeItemForTag:SJEdgeControlLayerBottomItem_Separator];
[_player.defaultEdgeControlLayer.bottomAdapter reload];
```
18.3 调整位置
```Objective-C
[_player.defaultEdgeControlLayer.bottomAdapter exchangeItemForTag:SJEdgeControlLayerBottomItem_DurationTime withItemForTag:SJEdgeControlLayerBottomItem_Progress];
[_player.defaultEdgeControlLayer.bottomAdapter reload];
```
19. 对控制层上的Item的一些补充
19.1 设置与前后item的间距
```Objective-C
SJEdgeControlButtonItem *titleItem = [_player.defaultEdgeControlLayer.topAdapter itemForTag:SJEdgeControlLayerTopItem_Title];
titleItem.insets = SJEdgeInsetsMake(16, 16);
[_player.defaultEdgeControlLayer.topAdapter reload];
```
19.2 设置隐藏
```Objective-C
SJEdgeControlButtonItem *titleItem = [_player.defaultEdgeControlLayer.topAdapter itemForTag:SJEdgeControlLayerTopItem_Title];
titleItem.hidden = YES;
[_player.defaultEdgeControlLayer.topAdapter reload];
```
19.3 填充剩余空间
```Objective-C
SJEdgeControlButtonItem *titleItem = [_player.defaultEdgeControlLayer.topAdapter itemForTag:SJEdgeControlLayerTopItem_Title];
titleItem.fill = YES;
[_player.defaultEdgeControlLayer.topAdapter reload];
```
20. SJEdgeControlLayer 的补充
20.1 是否竖屏时隐藏返回按钮
```Objective-C
_player.defaultEdgeControlLayer.hiddenBackButtonWhenOrientationIsPortrait = YES;
```
20.2 是否禁止网络状态变化提示
```Objective-C
_player.defaultEdgeControlLayer.disabledPromptWhenNetworkStatusChanges = YES;
```
20.3 是否使返回按钮常驻
```Objective-C
_player.defaultEdgeControlLayer.showResidentBackButton = YES;
```
20.4 是否隐藏底部进度条
```Objective-C
_player.defaultEdgeControlLayer.hiddenBottomProgressIndicator = YES;
```
20.5 是否在loadingView上显示网速
```Objective-C
_player.defaultEdgeControlLayer.showNetworkSpeedToLoadingView = YES;
```
20.6 自定义loadingView
```Objective-C
// 实现协议`SJLoadingView`即可, 然后赋值给控制层
_player.defaultEdgeControlLayer.loadingView = Your Loading View;
```
20.7 调整边距
```Objective-C
_player.defaultEdgeControlLayer.leftMargin = 16;
_player.defaultEdgeControlLayer.rightMargin = 16;
```
20.8 取消控制层上下视图的阴影
```Objective-C
[_player.defaultEdgeControlLayer.topContainerView cleanColors];
[_player.defaultEdgeControlLayer.bottomContainerView cleanColors];
```
## 赞助
如果对您有所帮助，欢迎您的赞赏
5.3 监听状态改变🔥
```Objective-C
///
/// 观察者
///
@property (nonatomic, strong, readonly) id deviceVolumeAndBrightnessObserver;
```
5.4 禁止播放器设置
```Objective-C
_player.disableBrightnessSetting = YES;
_player.disableVolumeSetting = YES;
```
5.5 自己动手撸一个 SJDeviceVolumeAndBrightnessManager, 替换作者原始实现
当需要对设备音量视图进行自定义时, 可以自己动手撸一个 SJDeviceVolumeAndBrightnessManager.
```Objective-C
_player.deviceVolumeAndBrightnessManager = Your deviceVolumeAndBrightnessManager;
```
___
8. 镜像翻转
此部分内容由 id<SJFlipTransitionManager> flipTransitionManager 提供支持
目前镜像翻转只写了 水平翻转, 未来可能会加入更多的翻转类型.
```Objective-C
typedef enum : NSUInteger {
SJViewFlipTransition_Identity,
SJViewFlipTransition_Horizontally, // 水平翻转
} SJViewFlipTransition;
```
8.1 翻转和恢复
```Objective-C
/// 当前的翻转类型
_player.flipTransition
/// 翻转相关方法
[_player setFlipTransition:SJViewFlipTransition_Horizontally];
[_player setFlipTransition:SJViewFlipTransition_Horizontally animated:YES];
[_player setFlipTransition:SJViewFlipTransition_Identity animated:YES completionHandler:^(__kindof SJBaseVideoPlayer * _Nonnull player) {
/// ...
}];
```
8.2 监听状态改变🔥
```Objective-C
///
/// 观察者
///
/// 可以如下设置block, 来监听某个状态的改变
///
/// player.flipTransitionObserver.flipTransitionDidStartExeBlock = ...;
/// player.flipTransitionObserver.flipTransitionDidStopExeBlock = ...;
///
@property (nonatomic, strong, readonly) id flipTransitionObserver;
```
8.3 自己动手撸一个 SJFlipTransitionManager, 替换作者原始实现
该部分管理类的协议定义在 SJFlipTransitionManagerProtocol 中, 实现该协议的任何对象, 均可赋值给播放器, 替换原始实现.
___
9. 网络状态
此部分内容由 id<SJReachability> reachability 提供支持
默认的 reachability 是个单例, 在App生命周期中, 仅创建一次. 因此每个播放器对象持有的 reachability 都是相同的.
9.1 当前的网络状态
```Objective-C
@property (nonatomic, readonly) SJNetworkStatus networkStatus;
```
9.2 监听状态改变🔥
```Objective-C
///
/// 观察者
///
@property (nonatomic, strong, readonly) id reachabilityObserver;
```
9.3 自己动手撸一个 SJReachability, 替换作者原始实现
该部分管理类的协议定义在 SJNetworkStatus 中, 实现该协议的任何对象, 均可赋值给播放器, 替换原始实现.
___
10. 手势
此部分内容由 id<SJPlayerGestureControl> gestureControl 提供支持
播放器默认存在四种手势, 每个手势触发的回调均定义在 SJPlayerGestureControl 中, 当想改变某个手势的处理时, 可以直接修改对应手势触发的 block 即可.
具体请看以下部分.
10.1 单击手势
当用户单击播放器时, 播放器会调用 [显示或隐藏控制层的操作](#4)
以下为默认实现:
```Objective-C
__weak typeof(self) _self = self;
_gestureControl.singleTapHandler = ^(id _Nonnull control, CGPoint location) {
__strong typeof(_self) self = _self;
if ( !self ) return ;
/// 让控制层显示或隐藏
[self.controlLayerAppearManager switchAppearState];
};
```
10.2 双击手势
双击会触发暂停或播放的操作
```Objective-C
__weak typeof(self) _self = self;
_gestureControl.doubleTapHandler = ^(id _Nonnull control, CGPoint location) {
__strong typeof(_self) self = _self;
if ( !self ) return ;
if ( [self playStatus_isPlaying] )
[self pause];
else
[self play];
};
```
10.3 移动手势
- 垂直滑动时, 默认情况下如果在屏幕左边, 则会触发调整亮度的操作, 并显示亮度提示视图. 如果在屏幕右边, 则会触发调整声音的操作, 并显示系统音量提示视图
- 水平滑动时, 会触发控制层相应的代理方法
```Objective-C
__weak typeof(self) _self = self;
_gestureControl.panHandler = ^(id _Nonnull control, SJPanGestureTriggeredPosition position, SJPanGestureMovingDirection direction, SJPanGestureRecognizerState state, CGPoint translate) {
__strong typeof(_self) self = _self;
if ( !self ) return ;
/// ....
};
```
10.4 捏合手势
当用户做放大或收缩触发该手势时, 会设置播放器显示模式`Aspect`或`AspectFill`.
```Objective-C
__weak typeof(self) _self = self;
_gestureControl.pinchHandler = ^(id _Nonnull control, CGFloat scale) {
__strong typeof(_self) self = _self;
if ( !self ) return ;
self.playbackController.videoGravity = scale > 1 ?AVLayerVideoGravityResizeAspectFill:AVLayerVideoGravityResizeAspect;
};
```
10.5 设置支持的手势
```Objective-C
_player.gestureControl.supportedGestureTypes = SJPlayerGestureTypeMask_Default
typedef enum : NSUInteger {
SJPlayerGestureTypeMask_None,
SJPlayerGestureTypeMask_SingleTap = 1 << 0,
SJPlayerGestureTypeMask_DoubleTap = 1 << 1,
SJPlayerGestureTypeMask_Pan_H = 1 << 2, // 水平方向
SJPlayerGestureTypeMask_Pan_V = 1 << 3, // 垂直方向
SJPlayerGestureTypeMask_Pinch = 1 << 4,
SJPlayerGestureTypeMask_LongPress = 1 << 5,
SJPlayerGestureTypeMask_Pan = SJPlayerGestureTypeMask_Pan_H | SJPlayerGestureTypeMask_Pan_V,
SJPlayerGestureTypeMask_Default = SJPlayerGestureTypeMask_SingleTap | SJPlayerGestureTypeMask_DoubleTap | SJPlayerGestureTypeMask_Pan | SJPlayerGestureTypeMask_Pinch,
SJPlayerGestureTypeMask_All = SJPlayerGestureTypeMask_Default | SJPlayerGestureTypeMask_LongPress,
} SJPlayerGestureTypeMask;
```
10.6 自定义某个手势的处理
```Objective-C
/// 例如 替换单击手势的处理
__weak typeof(self) _self = self;
_player.gestureControl.singleTapHandler = ^(id _Nonnull control, CGPoint location) {
__strong typeof(_self) self = _self;
if ( !self ) return ;
/// .....你的处理
};
```
___
11. 占位图
资源在初始化时, 由于暂时没有画面可以呈现, 会出现短暂的黑屏. 在此期间, 建议大家设置一下占位图.
11.1 设置本地占位图
```Objective-C
_player.presentView.placeholderImageView.image = [UIImage imageNamed:@"..."];
```
11.2 设置网络占位图
```Objective-C
[_player.presentView.placeholderImageView sd_setImageWithURL:URL placeholderImage:img];
```
11.3 是否隐藏占位图 - 播放器准备好显示时
```Objective-C
/// 播放器准备好显示时, 是否隐藏占位图
/// - 默认为YES
@property (nonatomic) BOOL hiddenPlaceholderImageViewWhenPlayerIsReadyForDisplay;
```
___
12. 显示提示文本
目前仅支持 NSAttributedString.
12.1 显示管理类
```Objective-C
///
/// 中心弹出文本提示
///
/// 了解更多请前往协议头文件查看
///
@property (nonatomic, strong, null_resettable) id prompt;
///
/// 左下角弹出提示
///
/// 了解更多请前往协议头文件查看
///
@property (nonatomic, strong, null_resettable) id popPromptController;
```
12.2 配置提示文本
```Objective-C
_player.prompt.backgroundColor = ...;
_player.prompt.contentInset = ...;
```
___
13. 一些固定代码
接入播放器的 ViewController 中, 会写一些固定的代码, 我将这些固定代码都封装在了以下方法中.
在适当的时候直接调用即可, 以下为内部实现:
13.4 - (BOOL)vc_prefersStatusBarHidden;
状态栏是否可以隐藏
实现如下:
```Objective-C
- (BOOL)vc_prefersStatusBarHidden {
if ( _tmpShowStatusBar ) return NO; // 临时显示
if ( _tmpHiddenStatusBar ) return YES; // 临时隐藏
if ( self.lockedScreen ) return YES; // 锁屏时, 不显示
if ( self.rotationManager.isTransitioning ) { // 旋转时, 不显示
if ( !self.disabledControlLayerAppearManager && self.isControlLayerAppeared ) return NO;
return YES;
}
// 全屏播放时, 使状态栏根据控制层显示或隐藏
if ( self.isFullScreen ) return !self.isControlLayerAppeared;
return NO;
}
```
13.5 - (UIStatusBarStyle)vc_preferredStatusBarStyle;
状态栏显示白色还是黑色
实现如下:
```Objective-C
- (UIStatusBarStyle)vc_preferredStatusBarStyle {
// 全屏播放时, 使状态栏变成白色
if ( self.isFullScreen || self.fitOnScreen ) return UIStatusBarStyleLightContent;
return UIStatusBarStyleDefault;
}
```
13.6 - 临时显示状态栏
有时候, 可能会希望临时显示状态栏, 例如全屏转回小屏时, 旋转之前, 需要将状态栏显示.
```Objective-C
[_player needShowStatusBar];
```
13.7 - 临时隐藏状态栏
有时候, 可能会希望临时隐藏状态栏, 例如某个播放器控制层不需要显示状态栏.
```Objective-C
[_player needHiddenStatusBar];
```
___
14. 截屏
14.1 当前时间截图
```Objective-C
UIImage *img = [_player screenshot];
```
14.2 指定时间截图
```Objective-C
- (void)screenshotWithTime:(NSTimeInterval)secs
completion:(void(^)(__kindof SJBaseVideoPlayer *videoPlayer, UIImage * __nullable image, NSError *__nullable error))block;
/// 可以通过 _player.playbackController.presentationSize 来获取当前视频宽高
- (void)screenshotWithTime:(NSTimeInterval)secs
size:(CGSize)size
completion:(void(^)(__kindof SJBaseVideoPlayer *videoPlayer, UIImage * __nullable image, NSError *__nullable error))block;
```
15. 导出视频或GIF
15.1 导出视频
```Objective-C
- (void)exportWithBeginTime:(NSTimeInterval)beginTime
duration:(NSTimeInterval)duration
presetName:(nullable NSString *)presetName
progress:(void(^)(__kindof SJBaseVideoPlayer *videoPlayer, float progress))progressBlock
completion:(void(^)(__kindof SJBaseVideoPlayer *videoPlayer, NSURL *fileURL, UIImage *thumbnailImage))completion
failure:(void(^)(__kindof SJBaseVideoPlayer *videoPlayer, NSError *error))failure;
```
15.2 导出GIF
```Objective-C
- (void)generateGIFWithBeginTime:(NSTimeInterval)beginTime
duration:(NSTimeInterval)duration
progress:(void(^)(__kindof SJBaseVideoPlayer *videoPlayer, float progress))progressBlock
completion:(void(^)(__kindof SJBaseVideoPlayer *videoPlayer, UIImage *imageGIF, UIImage *thumbnailImage, NSURL *filePath))completion
failure:(void(^)(__kindof SJBaseVideoPlayer *videoPlayer, NSError *error))failure;
```
15.3 取消操作
```Objective-C
/// 取消导出操作
/// 播放器 dealloc 时, 会调用一次
- (void)cancelExportOperation;
/// 取消GIF操作
/// 播放器 dealloc 时, 会调用一次
- (void)cancelGenerateGIFOperation;
```
16. 滚动相关
此部分的内容由 SJPlayModelPropertiesObserver 提供支持.
16.1 是否在 UICollectionView 或者 UITableView 中播放
```Objective-C
/// 是否是在 UICollectionView 或者 UITableView 中播放
_player.isPlayOnScrollView
```
16.2 是否已显示
```Objective-C
///
/// 播放器视图是否显示
///
/// Whether the player is appeared when playing on scrollView. Because scrollview may be scrolled.
///
@property (nonatomic, readonly) BOOL isScrollAppeared;
```
16.3 播放器视图将要滚动显示和消失的回调
```Objective-C
@property (nonatomic, copy, nullable) void(^playerViewWillAppearExeBlock)(__kindof SJBaseVideoPlayer *videoPlayer);
@property (nonatomic, copy, nullable) void(^playerViewWillDisappearExeBlock)(__kindof SJBaseVideoPlayer *videoPlayer);
```
16.4 滚动出去后, 是否暂停
```Objective-C
///
/// 滚动出去后, 是否暂停. 默认为YES
///
/// - default value is YES.
///
@property (nonatomic) BOOL pauseWhenScrollDisappeared;
```
16.5 滚动进入时, 是否恢复播放
```Objective-C
///
/// 滚动进入时, 是否恢复播放. 默认为YES
///
/// - default values is YES.
///
@property (nonatomic) BOOL resumePlaybackWhenScrollAppeared;
```
16.6 滚动出去后, 是否隐藏播放器视图
```Objective-C
///
/// 滚动出去后, 是否隐藏播放器视图. 默认为YES
///
/// - default value is YES.
///
@property (nonatomic) BOOL hiddenViewWhenScrollDisappeared;
```
17. 自动播放 - 在 UICollectionView 或者 UITableView 中
目前支持在 UICollectionViewCell 和 UITableViewCell 中自动播放.
使用之前, 请导入头文件 `#import "UIScrollView+ListViewAutoplaySJAdd.h"`
17.1 开启
```Objective-C
/// 配置列表自动播放
[_tableView sj_enableAutoplayWithConfig:[SJPlayerAutoplayConfig configWithPlayerSuperviewTag:101 autoplayDelegate:self]];
/// Delegate method
- (void)sj_playerNeedPlayNewAssetAtIndexPath:(NSIndexPath *)indexPath {
}
```
17.2 配置
```Objective-C
typedef NS_ENUM(NSUInteger, SJAutoplayScrollAnimationType) {
SJAutoplayScrollAnimationTypeNone,
SJAutoplayScrollAnimationTypeTop,
SJAutoplayScrollAnimationTypeMiddle,
};
@interface SJPlayerAutoplayConfig : NSObject
+ (instancetype)configWithPlayerSuperviewTag:(NSInteger)playerSuperviewTag
autoplayDelegate:(id)autoplayDelegate;
/// 滚动的动画类型
/// default is .Middle;
@property (nonatomic) SJAutoplayScrollAnimationType animationType;
@property (nonatomic, readonly) NSInteger playerSuperviewTag;
@property (nonatomic, weak, nullable, readonly) id autoplayDelegate;
@end
@protocol SJPlayerAutoplayDelegate
- (void)sj_playerNeedPlayNewAssetAtIndexPath:(NSIndexPath *)indexPath;
@end
```
17.3 关闭
```Objective-C
[_tableView sj_disenableAutoplay];
```
17.4 主动调用播放下一个资源
```Objective-C
[_tableView sj_needPlayNextAsset];
```
18. 对控制层上面的Item的操作
18.1 添加
```Objective-C
SJEdgeControlButtonItem *item = [[SJEdgeControlButtonItem alloc] initWithImage:[UIImage imageNamed:@"test"] target:self action:@selector(test) tag:SJTestImageItemTag];
[_player.defaultEdgeControlLayer.topAdapter addItem:item];
[_player.defaultEdgeControlLayer.topAdapter reload];
```
18.2 删除
```Objective-C
[_player.defaultEdgeControlLayer.bottomAdapter removeItemForTag:SJEdgeControlLayerBottomItem_Separator];
[_player.defaultEdgeControlLayer.bottomAdapter reload];
```
18.3 调整位置
```Objective-C
[_player.defaultEdgeControlLayer.bottomAdapter exchangeItemForTag:SJEdgeControlLayerBottomItem_DurationTime withItemForTag:SJEdgeControlLayerBottomItem_Progress];
[_player.defaultEdgeControlLayer.bottomAdapter reload];
```
19. 对控制层上的Item的一些补充
19.1 设置与前后item的间距
```Objective-C
SJEdgeControlButtonItem *titleItem = [_player.defaultEdgeControlLayer.topAdapter itemForTag:SJEdgeControlLayerTopItem_Title];
titleItem.insets = SJEdgeInsetsMake(16, 16);
[_player.defaultEdgeControlLayer.topAdapter reload];
```
19.2 设置隐藏
```Objective-C
SJEdgeControlButtonItem *titleItem = [_player.defaultEdgeControlLayer.topAdapter itemForTag:SJEdgeControlLayerTopItem_Title];
titleItem.hidden = YES;
[_player.defaultEdgeControlLayer.topAdapter reload];
```
19.3 填充剩余空间
```Objective-C
SJEdgeControlButtonItem *titleItem = [_player.defaultEdgeControlLayer.topAdapter itemForTag:SJEdgeControlLayerTopItem_Title];
titleItem.fill = YES;
[_player.defaultEdgeControlLayer.topAdapter reload];
```
20. SJEdgeControlLayer 的补充
20.1 是否竖屏时隐藏返回按钮
```Objective-C
_player.defaultEdgeControlLayer.hiddenBackButtonWhenOrientationIsPortrait = YES;
```
20.2 是否禁止网络状态变化提示
```Objective-C
_player.defaultEdgeControlLayer.disabledPromptWhenNetworkStatusChanges = YES;
```
20.3 是否使返回按钮常驻
```Objective-C
_player.defaultEdgeControlLayer.showResidentBackButton = YES;
```
20.4 是否隐藏底部进度条
```Objective-C
_player.defaultEdgeControlLayer.hiddenBottomProgressIndicator = YES;
```
20.5 是否在loadingView上显示网速
```Objective-C
_player.defaultEdgeControlLayer.showNetworkSpeedToLoadingView = YES;
```
20.6 自定义loadingView
```Objective-C
// 实现协议`SJLoadingView`即可, 然后赋值给控制层
_player.defaultEdgeControlLayer.loadingView = Your Loading View;
```
20.7 调整边距
```Objective-C
_player.defaultEdgeControlLayer.leftMargin = 16;
_player.defaultEdgeControlLayer.rightMargin = 16;
```
20.8 取消控制层上下视图的阴影
```Objective-C
[_player.defaultEdgeControlLayer.topContainerView cleanColors];
[_player.defaultEdgeControlLayer.bottomContainerView cleanColors];
```
## 赞助
如果对您有所帮助，欢迎您的赞赏
5.4 禁止播放器设置
```Objective-C
_player.disableBrightnessSetting = YES;
_player.disableVolumeSetting = YES;
```
5.5 自己动手撸一个 SJDeviceVolumeAndBrightnessManager, 替换作者原始实现
当需要对设备音量视图进行自定义时, 可以自己动手撸一个 SJDeviceVolumeAndBrightnessManager.
```Objective-C _player.deviceVolumeAndBrightnessManager = Your deviceVolumeAndBrightnessManager; ``` ___8. 镜像翻转
此部分内容由 id<SJFlipTransitionManager> flipTransitionManager 提供支持 目前镜像翻转只写了 水平翻转, 未来可能会加入更多的翻转类型.
```Objective-C typedef enum : NSUInteger { SJViewFlipTransition_Identity, SJViewFlipTransition_Horizontally, // 水平翻转 } SJViewFlipTransition; ```8.1 翻转和恢复
```Objective-C /// 当前的翻转类型 _player.flipTransition /// 翻转相关方法 [_player setFlipTransition:SJViewFlipTransition_Horizontally]; [_player setFlipTransition:SJViewFlipTransition_Horizontally animated:YES]; [_player setFlipTransition:SJViewFlipTransition_Identity animated:YES completionHandler:^(__kindof SJBaseVideoPlayer * _Nonnull player) { /// ... }]; ```8.2 监听状态改变🔥
```Objective-C /// /// 观察者 /// /// 可以如下设置block, 来监听某个状态的改变 /// /// player.flipTransitionObserver.flipTransitionDidStartExeBlock = ...; /// player.flipTransitionObserver.flipTransitionDidStopExeBlock = ...; /// @property (nonatomic, strong, readonly) id8.3 自己动手撸一个 SJFlipTransitionManager, 替换作者原始实现
该部分管理类的协议定义在 SJFlipTransitionManagerProtocol 中, 实现该协议的任何对象, 均可赋值给播放器, 替换原始实现.
___9. 网络状态
此部分内容由 id<SJReachability> reachability 提供支持 默认的 reachability 是个单例, 在App生命周期中, 仅创建一次. 因此每个播放器对象持有的 reachability 都是相同的.
9.1 当前的网络状态
```Objective-C @property (nonatomic, readonly) SJNetworkStatus networkStatus; ```9.2 监听状态改变🔥
```Objective-C /// /// 观察者 /// @property (nonatomic, strong, readonly) id9.3 自己动手撸一个 SJReachability, 替换作者原始实现
该部分管理类的协议定义在 SJNetworkStatus 中, 实现该协议的任何对象, 均可赋值给播放器, 替换原始实现.
___10. 手势
此部分内容由 id<SJPlayerGestureControl> gestureControl 提供支持 播放器默认存在四种手势, 每个手势触发的回调均定义在 SJPlayerGestureControl 中, 当想改变某个手势的处理时, 可以直接修改对应手势触发的 block 即可. 具体请看以下部分.
10.1 单击手势
当用户单击播放器时, 播放器会调用 [显示或隐藏控制层的操作](#4) 以下为默认实现: ```Objective-C __weak typeof(self) _self = self; _gestureControl.singleTapHandler = ^(id10.2 双击手势
双击会触发暂停或播放的操作
```Objective-C __weak typeof(self) _self = self; _gestureControl.doubleTapHandler = ^(id10.3 移动手势
- 垂直滑动时, 默认情况下如果在屏幕左边, 则会触发调整亮度的操作, 并显示亮度提示视图. 如果在屏幕右边, 则会触发调整声音的操作, 并显示系统音量提示视图 - 水平滑动时, 会触发控制层相应的代理方法 ```Objective-C __weak typeof(self) _self = self; _gestureControl.panHandler = ^(id10.4 捏合手势
当用户做放大或收缩触发该手势时, 会设置播放器显示模式`Aspect`或`AspectFill`.
```Objective-C __weak typeof(self) _self = self; _gestureControl.pinchHandler = ^(id10.5 设置支持的手势
```Objective-C _player.gestureControl.supportedGestureTypes = SJPlayerGestureTypeMask_Default typedef enum : NSUInteger { SJPlayerGestureTypeMask_None, SJPlayerGestureTypeMask_SingleTap = 1 << 0, SJPlayerGestureTypeMask_DoubleTap = 1 << 1, SJPlayerGestureTypeMask_Pan_H = 1 << 2, // 水平方向 SJPlayerGestureTypeMask_Pan_V = 1 << 3, // 垂直方向 SJPlayerGestureTypeMask_Pinch = 1 << 4, SJPlayerGestureTypeMask_LongPress = 1 << 5, SJPlayerGestureTypeMask_Pan = SJPlayerGestureTypeMask_Pan_H | SJPlayerGestureTypeMask_Pan_V, SJPlayerGestureTypeMask_Default = SJPlayerGestureTypeMask_SingleTap | SJPlayerGestureTypeMask_DoubleTap | SJPlayerGestureTypeMask_Pan | SJPlayerGestureTypeMask_Pinch, SJPlayerGestureTypeMask_All = SJPlayerGestureTypeMask_Default | SJPlayerGestureTypeMask_LongPress, } SJPlayerGestureTypeMask; ```10.6 自定义某个手势的处理
```Objective-C /// 例如 替换单击手势的处理 __weak typeof(self) _self = self; _player.gestureControl.singleTapHandler = ^(id11. 占位图
资源在初始化时, 由于暂时没有画面可以呈现, 会出现短暂的黑屏. 在此期间, 建议大家设置一下占位图.
11.1 设置本地占位图
```Objective-C _player.presentView.placeholderImageView.image = [UIImage imageNamed:@"..."]; ```11.2 设置网络占位图
```Objective-C [_player.presentView.placeholderImageView sd_setImageWithURL:URL placeholderImage:img]; ```11.3 是否隐藏占位图 - 播放器准备好显示时
```Objective-C /// 播放器准备好显示时, 是否隐藏占位图 /// - 默认为YES @property (nonatomic) BOOL hiddenPlaceholderImageViewWhenPlayerIsReadyForDisplay; ``` ___12. 显示提示文本
目前仅支持 NSAttributedString.
12.1 显示管理类
```Objective-C /// /// 中心弹出文本提示 /// /// 了解更多请前往协议头文件查看 /// @property (nonatomic, strong, null_resettable) id12.2 配置提示文本
```Objective-C _player.prompt.backgroundColor = ...; _player.prompt.contentInset = ...; ``` ___13. 一些固定代码
接入播放器的 ViewController 中, 会写一些固定的代码, 我将这些固定代码都封装在了以下方法中. 在适当的时候直接调用即可, 以下为内部实现:
13.4 - (BOOL)vc_prefersStatusBarHidden;
状态栏是否可以隐藏 实现如下:
```Objective-C - (BOOL)vc_prefersStatusBarHidden { if ( _tmpShowStatusBar ) return NO; // 临时显示 if ( _tmpHiddenStatusBar ) return YES; // 临时隐藏 if ( self.lockedScreen ) return YES; // 锁屏时, 不显示 if ( self.rotationManager.isTransitioning ) { // 旋转时, 不显示 if ( !self.disabledControlLayerAppearManager && self.isControlLayerAppeared ) return NO; return YES; } // 全屏播放时, 使状态栏根据控制层显示或隐藏 if ( self.isFullScreen ) return !self.isControlLayerAppeared; return NO; } ```13.5 - (UIStatusBarStyle)vc_preferredStatusBarStyle;
状态栏显示白色还是黑色 实现如下:
```Objective-C - (UIStatusBarStyle)vc_preferredStatusBarStyle { // 全屏播放时, 使状态栏变成白色 if ( self.isFullScreen || self.fitOnScreen ) return UIStatusBarStyleLightContent; return UIStatusBarStyleDefault; } ```13.6 - 临时显示状态栏
有时候, 可能会希望临时显示状态栏, 例如全屏转回小屏时, 旋转之前, 需要将状态栏显示.
```Objective-C [_player needShowStatusBar]; ```13.7 - 临时隐藏状态栏
有时候, 可能会希望临时隐藏状态栏, 例如某个播放器控制层不需要显示状态栏.
```Objective-C [_player needHiddenStatusBar]; ``` ___14. 截屏
14.1 当前时间截图
```Objective-C UIImage *img = [_player screenshot]; ```14.2 指定时间截图
```Objective-C - (void)screenshotWithTime:(NSTimeInterval)secs completion:(void(^)(__kindof SJBaseVideoPlayer *videoPlayer, UIImage * __nullable image, NSError *__nullable error))block; /// 可以通过 _player.playbackController.presentationSize 来获取当前视频宽高 - (void)screenshotWithTime:(NSTimeInterval)secs size:(CGSize)size completion:(void(^)(__kindof SJBaseVideoPlayer *videoPlayer, UIImage * __nullable image, NSError *__nullable error))block; ```15. 导出视频或GIF
15.1 导出视频
```Objective-C - (void)exportWithBeginTime:(NSTimeInterval)beginTime duration:(NSTimeInterval)duration presetName:(nullable NSString *)presetName progress:(void(^)(__kindof SJBaseVideoPlayer *videoPlayer, float progress))progressBlock completion:(void(^)(__kindof SJBaseVideoPlayer *videoPlayer, NSURL *fileURL, UIImage *thumbnailImage))completion failure:(void(^)(__kindof SJBaseVideoPlayer *videoPlayer, NSError *error))failure; ```15.2 导出GIF
```Objective-C - (void)generateGIFWithBeginTime:(NSTimeInterval)beginTime duration:(NSTimeInterval)duration progress:(void(^)(__kindof SJBaseVideoPlayer *videoPlayer, float progress))progressBlock completion:(void(^)(__kindof SJBaseVideoPlayer *videoPlayer, UIImage *imageGIF, UIImage *thumbnailImage, NSURL *filePath))completion failure:(void(^)(__kindof SJBaseVideoPlayer *videoPlayer, NSError *error))failure; ```15.3 取消操作
```Objective-C /// 取消导出操作 /// 播放器 dealloc 时, 会调用一次 - (void)cancelExportOperation; /// 取消GIF操作 /// 播放器 dealloc 时, 会调用一次 - (void)cancelGenerateGIFOperation; ```16. 滚动相关
此部分的内容由 SJPlayModelPropertiesObserver 提供支持.
16.1 是否在 UICollectionView 或者 UITableView 中播放
```Objective-C /// 是否是在 UICollectionView 或者 UITableView 中播放 _player.isPlayOnScrollView ```16.2 是否已显示
```Objective-C /// /// 播放器视图是否显示 /// /// Whether the player is appeared when playing on scrollView. Because scrollview may be scrolled. /// @property (nonatomic, readonly) BOOL isScrollAppeared; ```16.3 播放器视图将要滚动显示和消失的回调
```Objective-C @property (nonatomic, copy, nullable) void(^playerViewWillAppearExeBlock)(__kindof SJBaseVideoPlayer *videoPlayer); @property (nonatomic, copy, nullable) void(^playerViewWillDisappearExeBlock)(__kindof SJBaseVideoPlayer *videoPlayer); ```16.4 滚动出去后, 是否暂停
```Objective-C /// /// 滚动出去后, 是否暂停. 默认为YES /// /// - default value is YES. /// @property (nonatomic) BOOL pauseWhenScrollDisappeared; ```16.5 滚动进入时, 是否恢复播放
```Objective-C /// /// 滚动进入时, 是否恢复播放. 默认为YES /// /// - default values is YES. /// @property (nonatomic) BOOL resumePlaybackWhenScrollAppeared; ```16.6 滚动出去后, 是否隐藏播放器视图
```Objective-C /// /// 滚动出去后, 是否隐藏播放器视图. 默认为YES /// /// - default value is YES. /// @property (nonatomic) BOOL hiddenViewWhenScrollDisappeared; ```17. 自动播放 - 在 UICollectionView 或者 UITableView 中
目前支持在 UICollectionViewCell 和 UITableViewCell 中自动播放. 使用之前, 请导入头文件 `#import "UIScrollView+ListViewAutoplaySJAdd.h"`
17.1 开启
```Objective-C /// 配置列表自动播放 [_tableView sj_enableAutoplayWithConfig:[SJPlayerAutoplayConfig configWithPlayerSuperviewTag:101 autoplayDelegate:self]]; /// Delegate method - (void)sj_playerNeedPlayNewAssetAtIndexPath:(NSIndexPath *)indexPath { } ```17.2 配置
```Objective-C typedef NS_ENUM(NSUInteger, SJAutoplayScrollAnimationType) { SJAutoplayScrollAnimationTypeNone, SJAutoplayScrollAnimationTypeTop, SJAutoplayScrollAnimationTypeMiddle, }; @interface SJPlayerAutoplayConfig : NSObject + (instancetype)configWithPlayerSuperviewTag:(NSInteger)playerSuperviewTag autoplayDelegate:(id17.3 关闭
```Objective-C [_tableView sj_disenableAutoplay]; ```17.4 主动调用播放下一个资源
```Objective-C [_tableView sj_needPlayNextAsset]; ```18. 对控制层上面的Item的操作
18.1 添加
```Objective-C SJEdgeControlButtonItem *item = [[SJEdgeControlButtonItem alloc] initWithImage:[UIImage imageNamed:@"test"] target:self action:@selector(test) tag:SJTestImageItemTag]; [_player.defaultEdgeControlLayer.topAdapter addItem:item]; [_player.defaultEdgeControlLayer.topAdapter reload]; ```18.2 删除
```Objective-C [_player.defaultEdgeControlLayer.bottomAdapter removeItemForTag:SJEdgeControlLayerBottomItem_Separator]; [_player.defaultEdgeControlLayer.bottomAdapter reload]; ```18.3 调整位置
```Objective-C [_player.defaultEdgeControlLayer.bottomAdapter exchangeItemForTag:SJEdgeControlLayerBottomItem_DurationTime withItemForTag:SJEdgeControlLayerBottomItem_Progress]; [_player.defaultEdgeControlLayer.bottomAdapter reload]; ```19. 对控制层上的Item的一些补充
19.1 设置与前后item的间距
```Objective-C SJEdgeControlButtonItem *titleItem = [_player.defaultEdgeControlLayer.topAdapter itemForTag:SJEdgeControlLayerTopItem_Title]; titleItem.insets = SJEdgeInsetsMake(16, 16); [_player.defaultEdgeControlLayer.topAdapter reload]; ```19.2 设置隐藏
```Objective-C SJEdgeControlButtonItem *titleItem = [_player.defaultEdgeControlLayer.topAdapter itemForTag:SJEdgeControlLayerTopItem_Title]; titleItem.hidden = YES; [_player.defaultEdgeControlLayer.topAdapter reload]; ```19.3 填充剩余空间
```Objective-C SJEdgeControlButtonItem *titleItem = [_player.defaultEdgeControlLayer.topAdapter itemForTag:SJEdgeControlLayerTopItem_Title]; titleItem.fill = YES; [_player.defaultEdgeControlLayer.topAdapter reload]; ```20. SJEdgeControlLayer 的补充
20.1 是否竖屏时隐藏返回按钮
```Objective-C _player.defaultEdgeControlLayer.hiddenBackButtonWhenOrientationIsPortrait = YES; ```20.2 是否禁止网络状态变化提示
```Objective-C _player.defaultEdgeControlLayer.disabledPromptWhenNetworkStatusChanges = YES; ```20.3 是否使返回按钮常驻
```Objective-C _player.defaultEdgeControlLayer.showResidentBackButton = YES; ```20.4 是否隐藏底部进度条
```Objective-C _player.defaultEdgeControlLayer.hiddenBottomProgressIndicator = YES; ```20.5 是否在loadingView上显示网速
```Objective-C _player.defaultEdgeControlLayer.showNetworkSpeedToLoadingView = YES; ```20.6 自定义loadingView
```Objective-C // 实现协议`SJLoadingView`即可, 然后赋值给控制层 _player.defaultEdgeControlLayer.loadingView = Your Loading View; ```20.7 调整边距
```Objective-C _player.defaultEdgeControlLayer.leftMargin = 16; _player.defaultEdgeControlLayer.rightMargin = 16; ```20.8 取消控制层上下视图的阴影
```Objective-C [_player.defaultEdgeControlLayer.topContainerView cleanColors]; [_player.defaultEdgeControlLayer.bottomContainerView cleanColors]; ``` ## 赞助 如果对您有所帮助，欢迎您的赞赏