Classes

Objective-C

@interface FWAlertControllerAppearance : FWAlertAppearance

Objective-C

@interface FWAlertAction : NSObject <NSCopying>

+ (instancetype)actionWithTitle:(nullable NSString *)title style:(FWAlertActionStyle)style handler:(void (^ __nullable)(FWAlertAction *action))handler;
+ (instancetype)actionWithTitle:(nullable NSString *)title style:(FWAlertActionStyle)style appearance:(nullable FWAlertControllerAppearance *)appearance handler:(void (^ __nullable)(FWAlertAction *action))handler;

/** action的标题 */
@property(nullable, nonatomic, copy) NSString *title;
/** action的富文本标题 */
@property(nullable, nonatomic, copy) NSAttributedString *attributedTitle;
/** action的图标，位于title的左边 */
@property(nullable, nonatomic, copy) UIImage *image;
/** title跟image之间的间距 */
@property (nonatomic, assign) CGFloat imageTitleSpacing;
/** 渲染颜色,当外部的图片使用了UIImageRenderingModeAlwaysTemplate时,使用该属性可改变图片的颜色 */
@property (nonatomic, strong) UIColor *tintColor;
/** 是否能点击,默认为YES */
@property(nonatomic, getter=isEnabled) BOOL enabled;
/** action的标题颜色,这个颜色只是普通文本的颜色，富文本颜色需要用NSForegroundColorAttributeName */
@property(nonatomic, strong) UIColor *titleColor;
/** action的标题字体,如果文字太长显示不全，会自动改变字体自适应按钮宽度，最多压缩文字为原来的0.5倍封顶 */
@property(nonatomic, strong) UIFont *titleFont;
/** action的标题的内边距，如果在不改变字体的情况下想增大action的高度，可以设置该属性的top和bottom值,默认UIEdgeInsetsMake(0, 15, 0, 15) */
@property(nonatomic, assign) UIEdgeInsets titleEdgeInsets;

/** 样式 */
@property(nonatomic, readonly) FWAlertActionStyle style;
/** 自定义样式，默认为样式单例 */
@property (nonatomic, strong, readonly) FWAlertControllerAppearance *alertAppearance;

@end

Objective-C

@interface FWAlertController : UIViewController

Objective-C

@interface FWAlertPresentationController : UIPresentationController
@end

Objective-C

@interface FWAlertAnimation : NSObject <UIViewControllerAnimatedTransitioning>
+ (instancetype)animationIsPresenting:(BOOL)presenting;
@end

Objective-C

@interface FWAlertControllerImpl : NSObject <FWAlertPlugin>

/** 单例模式 */
@property (class, nonatomic, readonly) FWAlertControllerImpl *sharedInstance NS_SWIFT_NAME(shared);

/// 自定义Alert弹窗样式，nil时使用单例
@property (nonatomic, strong, nullable) FWAlertControllerAppearance *customAlertAppearance;

/// 自定义ActionSheet弹窗样式，nil时使用单例
@property (nonatomic, strong, nullable) FWAlertControllerAppearance *customSheetAppearance;

/// 点击暗色背景关闭时是否触发cancelBlock，默认NO
@property (nonatomic, assign) BOOL dimmingTriggerCancel;

/// 弹窗自定义句柄，show方法自动调用
@property (nonatomic, copy, nullable) void (^customBlock)(FWAlertController *alertController);

/// 显示自定义视图弹窗，无默认按钮
- (void)viewController:(UIViewController *)viewController
    showAlertWithStyle:(UIAlertControllerStyle)style
            headerView:(UIView *)headerView
                cancel:(nullable id)cancel
               actions:(nullable NSArray *)actions
           actionBlock:(nullable void (^)(NSInteger index))actionBlock
           cancelBlock:(nullable void (^)(void))cancelBlock
           customBlock:(nullable void (^)(id alertController))customBlock;

@end

Objective-C

@interface FWAlertAppearance : NSObject

Objective-C

@interface FWAlertPluginImpl : NSObject <FWAlertPlugin>

Objective-C

@interface FWImageFrame : NSObject

Objective-C

@interface FWImageCoder : NSObject

Objective-C

@interface FWAppBundle : FWModuleBundle

Objective-C

@interface FWAppConfigDefaultTemplate
    : NSObject <FWConfigurationTemplateProtocol>

Objective-C

@interface FWAppDelegate : UIResponder <UIApplicationDelegate>

Objective-C

@interface FWAppearance : NSObject

Objective-C

@interface FWAsset : NSObject

Objective-C

@interface FWAssetGroup : NSObject

- (instancetype)initWithPHCollection:(PHAssetCollection *)phAssetCollection;

- (instancetype)initWithPHCollection:(PHAssetCollection *)phAssetCollection fetchAssetsOptions:(nullable PHFetchOptions *)pHFetchOptions;

/// 仅能通过 initWithPHCollection 和 initWithPHCollection:fetchAssetsOption 方法修改 phAssetCollection 的值
@property(nonatomic, strong, readonly) PHAssetCollection *phAssetCollection;

/// 仅能通过 initWithPHCollection 和 initWithPHCollection:fetchAssetsOption 方法修改 phAssetCollection 后，产生一个对应的 PHAssetsFetchResults 保存到 phFetchResult 中
@property(nonatomic, strong, readonly) PHFetchResult *phFetchResult;

/// 相册的名称
- (nullable NSString *)name;

/// 相册内的资源数量，包括视频、图片、音频（如果支持）这些类型的所有资源
- (NSInteger)numberOfAssets;

/**
 *  相册的缩略图，即系统接口中的相册海报（Poster Image）
 *
 *  @return 相册的缩略图
 */
- (nullable UIImage *)posterImageWithSize:(CGSize)size;

/**
 *  枚举相册内所有的资源
 *
 *  @param albumSortType    相册内资源的排序方式，可以选择日期最新的排在最前面，也可以选择日期最新的排在最后面
 *  @param enumerationBlock 枚举相册内资源时调用的 block，参数 result 表示每次枚举时对应的资源。
 *                          枚举所有资源结束后，enumerationBlock 会被再调用一次，这时 result 的值为 nil。
 *                          可以以此作为判断枚举结束的标记
 */
- (void)enumerateAssetsWithOptions:(FWAlbumSortType)albumSortType usingBlock:(nullable void (^)(FWAsset * _Nullable resultAsset))enumerationBlock;

/**
 *  枚举相册内所有的资源，相册内资源按日期最新的排在最后面
 *
 *  @param enumerationBlock 枚举相册内资源时调用的 block，参数 result 表示每次枚举时对应的资源。
 *                          枚举所有资源结束后，enumerationBlock 会被再调用一次，这时 result 的值为 nil。
 *                          可以以此作为判断枚举结束的标记
 */
- (void)enumerateAssetsUsingBlock:(nullable void (^)(FWAsset * _Nullable result))enumerationBlock;

@end

Objective-C

@interface FWAssetManager : NSObject

Objective-C

@interface FWAttributedLabel : UIView

Objective-C

@interface FWAttributedLabelURL : NSObject

@property (nonatomic,strong)          id      linkData;
@property (nonatomic,assign)          NSRange range;
@property (nonatomic,strong,nullable) UIColor *color;

+ (FWAttributedLabelURL *)urlWithLinkData:(id)linkData
                                    range:(NSRange)range
                                    color:(nullable UIColor *)color;

@end

Objective-C

@interface FWAttributedLabelURLDetector : NSObject
@property (nonatomic,strong) id<FWAttributedLabelCustomURLDetector> detector;

+ (instancetype)shared;

- (void)detectLinks:(nullable NSString *)plainText completion:(FWAttributedLinkDetectCompletion)completion;
@end

Objective-C

@interface FWAttributedLabelAttachment : NSObject

@property (nonatomic,strong) id                    content;
@property (nonatomic,assign) UIEdgeInsets          margin;
@property (nonatomic,assign) FWAttributedAlignment alignment;
@property (nonatomic,assign) CGFloat               fontAscent;
@property (nonatomic,assign) CGFloat               fontDescent;
@property (nonatomic,assign) CGSize                maxSize;


+ (FWAttributedLabelAttachment *)attachmentWith:(id)content
                                         margin:(UIEdgeInsets)margin
                                      alignment:(FWAttributedAlignment)alignment
                                        maxSize:(CGSize)maxSize;

- (CGSize)boxSize;

@end

Objective-C

@interface FWAudioPlayer : NSObject

Objective-C

@interface FWLayoutChain : NSObject

Objective-C

@interface FWAutoloader : NSObject

Objective-C

@interface FWBadgeView : UIView

Objective-C

@interface FWBannerView : UIView

Objective-C

@interface FWBannerViewCell : UICollectionViewCell

@property (nonatomic, weak, nullable) UIImageView *imageView;
@property (nonatomic, copy, nullable) NSString *title;

@property (nonatomic, strong, nullable) UIColor *titleLabelTextColor;
@property (nonatomic, strong, nullable) UIFont *titleLabelTextFont;
@property (nonatomic, strong, nullable) UIColor *titleLabelBackgroundColor;
@property (nonatomic, assign) CGFloat titleLabelHeight;
@property (nonatomic, assign) NSTextAlignment titleLabelTextAlignment;
@property (nonatomic, assign) UIEdgeInsets contentViewInset;
@property (nonatomic, assign) CGFloat contentViewCornerRadius;

@property (nonatomic, assign) BOOL hasConfigured;

/** 只展示文字轮播 */
@property (nonatomic, assign) BOOL onlyDisplayText;

@end

Objective-C

@interface FWBarrageRenderView : UIView <CAAnimationDelegate> {
    NSMutableArray<FWBarrageCell *> *_animatingCells;
    NSMutableArray<FWBarrageCell *> *_idleCells;
    dispatch_semaphore_t _animatingCellsLock;
    dispatch_semaphore_t _idleCellsLock;
    dispatch_semaphore_t _trackInfoLock;
    FWBarrageCell *_lastestCell;
    UIView *_lowPositionView;
    UIView *_middlePositionView;
    UIView *_highPositionView;
    UIView *_veryHighPositionView;
    BOOL _autoClear;
    FWBarrageRenderStatus _renderStatus;
    NSMutableDictionary *_trackNextAvailableTime;
}

@property (nonatomic, strong, readonly) NSMutableArray<FWBarrageCell *> *animatingCells;
@property (nonatomic, strong, readonly) NSMutableArray<FWBarrageCell *> *idleCells;
@property (nonatomic, assign) FWBarrageRenderPositionStyle renderPositionStyle;
@property (nonatomic, assign, readonly) FWBarrageRenderStatus renderStatus;

- (nullable FWBarrageCell *)dequeueReusableCellWithClass:(Class)barrageCellClass;
- (void)fireBarrageCell:(FWBarrageCell *)barrageCell;
- (BOOL)trigerActionWithPoint:(CGPoint)touchPoint;

- (void)start;
- (void)pause;
- (void)resume;
- (void)stop;

@end

Objective-C

@interface FWBarrageManager : NSObject {
  FWBarrageRenderView *_renderView;
}

Objective-C

@interface FWBarrageDescriptor : NSObject

@property (nonatomic, assign, nullable) Class barrageCellClass;
@property (nonatomic, assign) FWBarragePositionPriority positionPriority;//显示位置normal型的渲染在low型的上面, height型的渲染在normal上面
@property (nonatomic, assign) CGFloat animationDuration;//动画时间, 时间越长速度越慢, 时间越短速度越快
@property (nonatomic, assign) CGFloat fixedSpeed;//固定速度, 可以防止弹幕在有空闲轨道的情况下重叠, 取值0.0~100.0, animationDuration与fixedSpeed只能选择一个, fixedSpeed设置之后可以不用设置animationDuration

@property (nonatomic, copy, nullable) FWBarrageCellTouchedAction cellTouchedAction;//新属性里回传了被点击的cell, 可以在代码块里更改被点击的cell的属性, 比如之前有用户需要在弹幕被点击的时候修改被点击的弹幕的文字颜色等等. 用来替代旧版本的touchAction
@property (nonatomic, strong, nullable) UIColor *borderColor; // Default is no border
@property (nonatomic, assign) CGFloat borderWidth; // Default is 0
@property (nonatomic, assign) CGFloat cornerRadius; // Default is 8

@property (nonatomic, assign) NSRange renderRange;//渲染范围, 最终渲染出来的弹幕的Y坐标最小不小于renderRange.location, 最大不超过renderRange.length-barrageCell.height

@end

Objective-C

@interface FWBarrageCell : UIView
@property (nonatomic, assign, getter=isIdle) BOOL idle;//是否是空闲状态
@property (nonatomic, assign) NSTimeInterval idleTime;//开始闲置的时间, 闲置超过5秒的, 自动回收内存
@property (nonatomic, strong, nullable) FWBarrageDescriptor *barrageDescriptor;
@property (nonatomic, strong, readonly, nullable) CAAnimation *barrageAnimation;
@property (nonatomic, assign) int trackIndex;

- (void)addBarrageAnimationWithDelegate:(id<CAAnimationDelegate>)animationDelegate;
- (void)prepareForReuse;
- (void)clearContents;

- (void)updateSubviewsData;
- (void)layoutContentSubviews;
- (void)convertContentToImage;
- (void)sizeToFit;//设置好数据之后调用一下自动计算bounds
- (void)removeSubViewsAndSublayers;//默认删除所有的subview和sublayer; 如果需要选择性的删除可以重写这个方法.
- (void)addBorderAttributes;

@end

Objective-C

@interface FWBarrageTextDescriptor : FWBarrageDescriptor {
    NSMutableDictionary *_textAttribute;
}

@property (nonatomic, strong, nullable) UIFont *textFont;
@property (nonatomic, strong, nullable) UIColor *textColor;

/*
 * 关闭文字阴影可大幅提升性能, 推荐使用strokeColor, 与shadowColor相比strokeColor性能更强悍
 */
@property (nonatomic, assign) BOOL textShadowOpened;//默认NO
@property (nonatomic, strong, nullable) UIColor *shadowColor;//默认黑色
@property (nonatomic, assign) CGSize shadowOffset;//默认CGSizeZero
@property (nonatomic, assign) CGFloat shadowRadius;//默认2.0
@property (nonatomic, assign) CGFloat shadowOpacity;//默认0.5

@property (nonatomic, strong, nullable) UIColor *strokeColor;
@property (nonatomic, assign) int strokeWidth;//笔画宽度(粗细)，取值为 NSNumber 对象（整数），负值填充效果，正值中空效果

@property (nonatomic, copy, nullable) NSString *text;
@property (nonatomic, copy, nullable) NSAttributedString *attributedText;

@end

Objective-C

@interface FWBarrageTextCell : FWBarrageCell

@property (nonatomic, strong) UILabel *textLabel;
@property (nonatomic, strong, nullable) FWBarrageTextDescriptor *textDescriptor;

@end

Objective-C

@interface FWBarrageTrackInfo : NSObject

@property (nonatomic, assign) int trackIndex;
@property (nonatomic, copy, nullable) NSString *trackIdentifier;
@property (nonatomic, assign) CFTimeInterval nextAvailableTime;//下次可用的时间
@property (nonatomic, assign) NSInteger barrageCount;//当前行的弹幕数量
@property (nonatomic, assign) CGFloat trackHeight;//轨道高度

@end

Objective-C

@interface FWBaseRequest : NSObject

Objective-C

@interface FWBatchRequest : NSObject

Objective-C

@interface FWTapGestureRecognizer : UITapGestureRecognizer

Objective-C

@interface FWCacheEngine : NSObject <FWCacheProtocol>

Objective-C

@interface FWCacheFile : FWCacheEngine

Objective-C

@interface FWCacheKeychain : FWCacheEngine

Objective-C

@interface FWCacheManager : NSObject

Objective-C

@interface FWCacheMemory : FWCacheEngine

Objective-C

@interface FWCacheSqlite : FWCacheEngine

Objective-C

@interface FWCacheUserDefaults : FWCacheEngine

Objective-C

@interface FWChainRequest : NSObject

Objective-C

@interface FWCollectionViewSectionConfig : NSObject

Objective-C

@interface FWCollectionViewFlowLayout : UICollectionViewFlowLayout

Objective-C

@interface FWCollectionViewWaterfallLayout : UICollectionViewLayout

Objective-C

@interface FWCollectionViewAlignLayout : UICollectionViewFlowLayout

Objective-C

@interface FWConfiguration : NSObject

Objective-C

@interface FWDatabaseManager : NSObject

Objective-C

@interface FWDrawerView : NSObject

Objective-C

@interface FWEmptyPluginImpl : NSObject <FWEmptyPlugin>

Objective-C

@interface FWEmptyView : UIView

Objective-C

@interface FWScrollOverlayView : UIView

@end

Objective-C

@interface FWExceptionManager : NSObject

Objective-C

@interface FWFloatLayoutView : UIView

Objective-C

@interface FWGridView : UIView

Objective-C

@interface FWHTTPSessionManager
    : FWURLSessionManager <NSSecureCoding, NSCopying>

Objective-C

@interface FWIcon : NSObject

Objective-C

@interface FWImageCropController : UIViewController

Objective-C

@interface FWImageCropOverlayView : UIView

/** Hides the interior grid lines, sans animation. */
@property (nonatomic, assign) BOOL gridHidden;

/** Add/Remove the interior horizontal grid lines. */
@property (nonatomic, assign) BOOL displayHorizontalGridLines;

/** Add/Remove the interior vertical grid lines. */
@property (nonatomic, assign) BOOL displayVerticalGridLines;

/** Shows and hides the interior grid lines with an optional crossfade animation. */
- (void)setGridHidden:(BOOL)hidden animated:(BOOL)animated;

@end

Objective-C

@interface FWImageCropScrollView : UIScrollView

@property (nullable, nonatomic, copy) void (^touchesBegan)(void);
@property (nullable, nonatomic, copy) void (^touchesCancelled)(void);
@property (nullable, nonatomic, copy) void (^touchesEnded)(void);

@end

Objective-C

@interface FWImageCropToolbar : UIView

/* In horizontal mode, offsets all of the buttons vertically by height of status bar. */
@property (nonatomic, assign) CGFloat statusBarHeightInset;
/// 按钮内边距，默认16
@property (nonatomic, assign) CGFloat buttonInsetPadding;

/* Set an inset that will expand the background view beyond the bounds. */
@property (nonatomic, strong, readonly) UIView *backgroundView;
@property (nonatomic, assign) UIEdgeInsets backgroundViewOutsets;

/* The 'Done' buttons to commit the crop. The text button is displayed
 in portrait mode and the icon one, in landscape. */
@property (nonatomic, strong, readonly) UIButton *doneTextButton;
@property (nonatomic, strong, readonly) UIButton *doneIconButton;
@property (nonatomic, copy) NSString *doneTextButtonTitle;


/* The 'Cancel' buttons to cancel the crop. The text button is displayed
 in portrait mode and the icon one, in landscape. */
@property (nonatomic, strong, readonly) UIButton *cancelTextButton;
@property (nonatomic, strong, readonly) UIButton *cancelIconButton;
@property (nonatomic, readonly) UIView *visibleCancelButton;
@property (nonatomic, copy) NSString *cancelTextButtonTitle;

/* The cropper control buttons */
@property (nonatomic, strong, readonly)  UIButton *rotateCounterclockwiseButton;
@property (nonatomic, strong, readonly)  UIButton *resetButton;
@property (nonatomic, strong, readonly)  UIButton *clampButton;
@property (nullable, nonatomic, strong, readonly) UIButton *rotateClockwiseButton;

@property (nonatomic, readonly) UIButton *rotateButton; // Points to `rotateCounterClockwiseButton`

/* Button feedback handler blocks */
@property (nullable, nonatomic, copy) void (^cancelButtonTapped)(void);
@property (nullable, nonatomic, copy) void (^doneButtonTapped)(void);
@property (nullable, nonatomic, copy) void (^rotateCounterclockwiseButtonTapped)(void);
@property (nullable, nonatomic, copy) void (^rotateClockwiseButtonTapped)(void);
@property (nullable, nonatomic, copy) void (^clampButtonTapped)(void);
@property (nullable, nonatomic, copy) void (^resetButtonTapped)(void);

/* State management for the 'clamp' button */
@property (nonatomic, assign) BOOL clampButtonGlowing;
@property (nonatomic, readonly) CGRect clampButtonFrame;

/* Aspect ratio button visibility settings */
@property (nonatomic, assign) BOOL clampButtonHidden;
@property (nonatomic, assign) BOOL rotateCounterclockwiseButtonHidden;
@property (nonatomic, assign) BOOL rotateClockwiseButtonHidden;
@property (nonatomic, assign) BOOL resetButtonHidden;
@property (nonatomic, assign) BOOL doneButtonHidden;
@property (nonatomic, assign) BOOL cancelButtonHidden;

/* Enable the reset button */
@property (nonatomic, assign) BOOL resetButtonEnabled;

/* Done button frame for popover controllers */
@property (nonatomic, readonly) CGRect doneButtonFrame;

@end

Objective-C

@interface FWImageCropView : UIView

/**
 The image that the crop view is displaying. This cannot be changed once the crop view is instantiated.
 */
@property (nonnull, nonatomic, strong, readonly) UIImage *image;

/**
 The cropping style of the crop view (eg, rectangular or circular)
 */
@property (nonatomic, assign, readonly) FWImageCropCroppingStyle croppingStyle;

/**
 A grid view overlaid on top of the foreground image view's container.
 */
@property (nonnull, nonatomic, strong, readonly) FWImageCropOverlayView *gridOverlayView;

/**
 A container view that clips the a copy of the image so it appears over the dimming view
 */
@property (nonnull, nonatomic, readonly) UIView *foregroundContainerView;

/**
 A delegate object that receives notifications from the crop view
 */
@property (nullable, nonatomic, weak) id<FWImageCropViewDelegate> delegate;

/**
 If false, the user cannot resize the crop box frame using a pan gesture from a corner.
 Default vaue is YES.
 */
@property (nonatomic, assign) BOOL cropBoxResizeEnabled;

/**
 Whether the user has manipulated the crop view to the point where it can be reset
 */
@property (nonatomic, readonly) BOOL canBeReset;

/**
 The frame of the cropping box in the coordinate space of the crop view
 */
@property (nonatomic, readonly) CGRect cropBoxFrame;

/**
 The frame of the entire image in the backing scroll view
 */
@property (nonatomic, readonly) CGRect imageViewFrame;

/**
 Inset the workable region of the crop view in case in order to make space for accessory views
 */
@property (nonatomic, assign) UIEdgeInsets cropRegionInsets;

/**
 Disable the dynamic translucency in order to smoothly relayout the view
 */
@property (nonatomic, assign) BOOL simpleRenderMode;

/**
 When performing manual content layout (such as during screen rotation), disable any internal layout
 */
@property (nonatomic, assign) BOOL internalLayoutDisabled;

/**
 A width x height ratio that the crop box will be rescaled to (eg 4:3 is {4.0f, 3.0f})
 Setting it to CGSizeZero will reset the aspect ratio to the image's own ratio.
 */
@property (nonatomic, assign) CGSize aspectRatio;

/**
 When the cropping box is locked to its current aspect ratio (But can still be resized)
 */
@property (nonatomic, assign) BOOL aspectRatioLockEnabled;

/**
 If true, a custom aspect ratio is set, and the aspectRatioLockEnabled is set to YES,
 the crop box will swap it's dimensions depending on portrait or landscape sized images.
 This value also controls whether the dimensions can swap when the image is rotated.
 
 Default is NO.
 */
@property (nonatomic, assign) BOOL aspectRatioLockDimensionSwapEnabled;

/**
 When the user taps 'reset', whether the aspect ratio will also be reset as well
 Default is YES
 */
@property (nonatomic, assign) BOOL resetAspectRatioEnabled;

/**
 True when the height of the crop box is bigger than the width
 */
@property (nonatomic, readonly) BOOL cropBoxAspectRatioIsPortrait;

/**
 The rotation angle of the crop view (Will always be negative as it rotates in a counter-clockwise direction)
 */
@property (nonatomic, assign) NSInteger angle;

/**
 Hide all of the crop elements for transition animations
 */
@property (nonatomic, assign) BOOL croppingViewsHidden;

/**
 In relation to the coordinate space of the image, the frame that the crop view is focusing on
 */
@property (nonatomic, assign) CGRect imageCropFrame;

/**
 Set the grid overlay graphic to be hidden
 */
@property (nonatomic, assign) BOOL gridOverlayHidden;

///**
// Paddings of the crop rectangle. Default to 14.0
// */
@property (nonatomic) CGFloat cropViewPadding;

/**
 Delay before crop frame is adjusted according new crop area. Default to 0.8
 */
@property (nonatomic) NSTimeInterval cropAdjustingDelay;

/**
The minimum croping aspect ratio. If set, user is prevented from setting cropping
 rectangle to lower aspect ratio than defined by the parameter.
*/
@property (nonatomic, assign) CGFloat minimumAspectRatio;

/**
 The maximum scale that user can apply to image by pinching to zoom. Small values
 are only recomended with aspectRatioLockEnabled set to true. Default to 15.0
 */
@property (nonatomic, assign) CGFloat maximumZoomScale;

/**
 Always show the cropping grid lines, even when the user isn't interacting.
 This also disables the fading animation.
 (Default is NO)
 */
@property (nonatomic, assign) BOOL alwaysShowCroppingGrid;

/**
 Permanently hides the translucency effect covering the outside bounds of the
 crop box. (Default is NO)
 */
@property (nonatomic, assign) BOOL translucencyAlwaysHidden;

/**
 Create a default instance of the crop view with the supplied image
 */
- (nonnull instancetype)initWithImage:(nonnull UIImage *)image;

/**
 Create a new instance of the crop view with the specified image and cropping
 */
- (nonnull instancetype)initWithCroppingStyle:(FWImageCropCroppingStyle)style image:(nonnull UIImage *)image;

/**
 Performs the initial set up, including laying out the image and applying any restore properties.
 This should be called once the crop view has been added to a parent that is in its final layout frame.
 */
- (void)performInitialSetup;

/**
 When performing large size transitions (eg, orientation rotation),
 set simple mode to YES to temporarily graphically heavy effects like translucency.
 
 @param simpleMode Whether simple mode is enabled or not
 
 */
- (void)setSimpleRenderMode:(BOOL)simpleMode animated:(BOOL)animated;

/**
 When performing a screen rotation that will change the size of the scroll view, this takes
 a snapshot of all of the scroll view data before it gets manipulated by iOS.
 Please call this in your view controller, before the rotation animation block is committed.
 */
- (void)prepareforRotation;

/**
 Performs the realignment of the crop view while the screen is rotating.
 Please call this inside your view controller's screen rotation animation block.
 */
- (void)performRelayoutForRotation;

/**
 Reset the crop box and zoom scale back to the initial layout
 
 @param animated The reset is animated
 */
- (void)resetLayoutToDefaultAnimated:(BOOL)animated;

/**
 Changes the aspect ratio of the crop box to match the one specified
 
 @param aspectRatio The aspect ratio (For example 16:9 is 16.0f/9.0f). 'CGSizeZero' will reset it to the image's own ratio
 @param animated Whether the locking effect is animated
 */
- (void)setAspectRatio:(CGSize)aspectRatio animated:(BOOL)animated;

/**
 Rotates the entire canvas to a 90-degree angle. The default rotation is counterclockwise.
 
 @param animated Whether the transition is animated
 */
- (void)rotateImageNinetyDegreesAnimated:(BOOL)animated;

/**
 Rotates the entire canvas to a 90-degree angle
 
 @param animated Whether the transition is animated
 @param clockwise Whether the rotation is clockwise. Passing 'NO' means counterclockwise
 */
- (void)rotateImageNinetyDegreesAnimated:(BOOL)animated clockwise:(BOOL)clockwise;

/**
 Animate the grid overlay graphic to be visible
 */
- (void)setGridOverlayHidden:(BOOL)gridOverlayHidden animated:(BOOL)animated;

/**
 Animate the cropping component views to become visible
 */
- (void)setCroppingViewsHidden:(BOOL)hidden animated:(BOOL)animated;

/**
 Animate the background image view to become visible
 */
- (void)setBackgroundImageViewHidden:(BOOL)hidden animated:(BOOL)animated;

/**
 When triggered, the crop view will perform a relayout to ensure the crop box
 fills the entire crop view region
 */
- (void)moveCroppedContentToCenterAnimated:(BOOL)animated;

@end

Objective-C

@interface FWImageAlbumTableCell : UITableViewCell

Objective-C

@interface FWImageAlbumController
    : UIViewController <UITableViewDataSource, UITableViewDelegate>

Objective-C

@interface FWImagePickerPreviewController
    : FWImagePreviewController <UICollectionViewDataSource,
                                UICollectionViewDelegate,
                                FWImagePreviewViewDelegate>

Objective-C

@interface FWImagePickerPreviewCollectionCell : UICollectionViewCell

/// 缩略图视图
@property(nonatomic, strong, readonly) UIImageView *imageView;
/// imageView内边距，默认zero占满
@property(nonatomic, assign) UIEdgeInsets imageViewInsets UI_APPEARANCE_SELECTOR;
/// 选中边框颜色，默认白色
@property(nullable, nonatomic, strong) UIColor *checkedBorderColor UI_APPEARANCE_SELECTOR;
/// 选中边框宽度，默认3
@property(nonatomic, assign) CGFloat checkedBorderWidth UI_APPEARANCE_SELECTOR;
/// 禁用时蒙层颜色
@property(nonatomic, strong, nullable) UIColor *disabledMaskColor UI_APPEARANCE_SELECTOR;
/// 蒙层视图
@property(nonatomic, strong, readonly) UIView *maskView;
/// 当前是否选中
@property(nonatomic, assign) BOOL checked;
/// 当前是否禁用，默认NO
@property(nonatomic, assign) BOOL disabled;

@property(nonatomic, strong, readonly) UILabel *videoDurationLabel;
/// 是否显示videoDurationLabel，默认YES
@property(nonatomic, assign) BOOL showsVideoDurationLabel UI_APPEARANCE_SELECTOR;
/// videoDurationLabel 的字号
@property(nonatomic, strong) UIFont *videoDurationLabelFont UI_APPEARANCE_SELECTOR;
/// videoDurationLabel 的字体颜色
@property(nonatomic, strong) UIColor *videoDurationLabelTextColor UI_APPEARANCE_SELECTOR;
/// 视频时长文字的间距，相对于 cell 右下角而言，也即如果 right 越大则越往左，bottom 越大则越往上，另外 top 会影响底部遮罩的高度
@property(nonatomic, assign) UIEdgeInsets videoDurationLabelMargins UI_APPEARANCE_SELECTOR;

/// 左下角图标视图，默认判断显示editedIconImage和videoIconImage
@property(nonatomic, strong, readonly) UIImageView *iconImageView;
@property(nullable, nonatomic, strong) UIImage *editedIconImage UI_APPEARANCE_SELECTOR;
@property(nullable, nonatomic, strong) UIImage *videoIconImage UI_APPEARANCE_SELECTOR;
@property(nonatomic, assign) UIEdgeInsets iconImageViewMargins UI_APPEARANCE_SELECTOR;

/// 当前这个 cell 正在展示的 FWAsset 的 identifier
@property(nonatomic, copy, nullable) NSString *assetIdentifier;
- (void)renderWithAsset:(FWAsset *)asset referenceSize:(CGSize)referenceSize;

@end

Objective-C

@interface FWImagePickerController : UIViewController <UICollectionViewDataSource, UICollectionViewDelegate, FWImagePickerPreviewControllerDelegate>

@property(nullable, nonatomic, weak) id<FWImagePickerControllerDelegate> imagePickerControllerDelegate;
/// 自定义预览控制器句柄，优先级低于delegate
@property(nullable, nonatomic, copy) FWImagePickerPreviewController * (^previewControllerBlock)(void);
/// 自定义相册控制器句柄，优先级低于delegate
@property(nullable, nonatomic, copy) FWImageAlbumController * (^albumControllerBlock)(void);
/// 自定义cell展示句柄，cellForItem自动调用，优先级低于delegate
@property(nullable, nonatomic, copy) void (^customCellBlock)(FWImagePickerCollectionCell *cell, NSIndexPath *indexPath);

/// 图片选取完成回调句柄，优先级低于delegate
@property(nullable, nonatomic, copy) void (^didFinishPicking)(NSArray<FWAsset *> *imagesAssetArray);
/// 图片选取取消回调句柄，优先级低于delegate
@property(nullable, nonatomic, copy) void (^didCancelPicking)(void);

@property(nullable, nonatomic, strong) UIColor *toolBarBackgroundColor;
@property(nullable, nonatomic, strong) UIColor *toolBarTintColor;

/// 当前titleView，默认不可点击，contentType方式会自动切换点击状态
@property(nonatomic, strong, readonly) FWToolbarTitleView *titleView;
/// 标题视图accessoryImage，默认nil，contentType方式会自动设置
@property(nullable, nonatomic, strong) UIImage *titleAccessoryImage;

/*
 * 图片的最小尺寸，布局时如果有剩余空间，会将空间分配给图片大小，所以最终显示出来的大小不一定等于minimumImageWidth。默认是75。
 * @warning collectionViewLayout 和 collectionView 可能有设置 sectionInsets 和 contentInsets，所以设置几行不可以简单的通过 screenWdith / columnCount 来获得
 */
@property(nonatomic, assign) CGFloat minimumImageWidth;
/// 图片显示列数，默认0使用minimumImageWidth自动计算，指定后固定列数
@property(nonatomic, assign) NSInteger imageColumnCount;

@property(nonatomic, strong, readonly) UICollectionViewFlowLayout *collectionViewLayout;
@property(nonatomic, strong, readonly) UICollectionView *collectionView;

@property(nonatomic, strong, readonly) UIView *operationToolBarView;
/// 自定义工具栏高度，默认同系统
@property(nonatomic, assign) CGFloat operationToolBarHeight;
@property(nonatomic, assign) CGFloat toolBarPaddingHorizontal;
@property(nonatomic, strong, readonly) UIButton *previewButton;
@property(nonatomic, strong, readonly) UIButton *sendButton;

/// 也可以直接传入 FWAssetGroup，然后读取其中的 FWAsset 并储存到 imagesAssetArray 中，传入后会赋值到 FWAssetGroup，并自动刷新 UI 展示
- (void)refreshWithAssetsGroup:(FWAssetGroup * _Nullable)assetsGroup;

/// 根据filterType刷新，自动选取第一个符合条件的相册，自动初始化并使用albumController
- (void)refreshWithFilterType:(FWImagePickerFilterType)filterType;

@property(nullable, nonatomic, strong, readonly) NSMutableArray<FWAsset *> *imagesAssetArray;
@property(nullable, nonatomic, strong, readonly) FWAssetGroup *assetsGroup;
/// 图片过滤类型，默认0不过滤，影响requestImage结果和previewController预览效果
@property(nonatomic, assign) FWImagePickerFilterType filterType;

/// 当前被选择的图片对应的 FWAsset 对象数组
@property(nullable, nonatomic, strong, readonly) NSMutableArray<FWAsset *> *selectedImageAssetArray;

/// 是否允许图片多选，默认为 YES。如果为 NO，则不显示 checkbox 和底部工具栏
@property(nonatomic, assign) BOOL allowsMultipleSelection;

/// 是否禁用预览时左右滚动，默认NO。如果为YES，单选时不能左右滚动切换图片
@property(nonatomic, assign) BOOL previewScrollDisabled;

/// 最多可以选择的图片数，默认为9
@property(nonatomic, assign) NSUInteger maximumSelectImageCount;

/// 最少需要选择的图片数，默认为 0
@property(nonatomic, assign) NSUInteger minimumSelectImageCount;

/// 是否显示默认loading，优先级低于delegate，默认YES
@property(nonatomic, assign) BOOL showsDefaultLoading;

/// 是否需要请求图片资源，默认NO，开启后会先requestImagesAssetArray再回调didFinishPicking
@property(nonatomic, assign) BOOL shouldRequestImage;

/// 图片过滤类型转换为相册内容类型
+ (FWAlbumContentType)albumContentTypeWithFilterType:(FWImagePickerFilterType)filterType;

/**
 * 检查并下载一组资源，如果资源仍未从 iCloud 中成功下载，则会发出请求从 iCloud 加载资源，下载完成后，主线程回调。
 * 图片资源对象和结果信息保存在FWAsset.requestObject，自动根据过滤类型返回UIImage|PHLivePhoto|NSURL
 */
+ (void)requestImagesAssetArray:(NSArray<FWAsset *> *)imagesAssetArray
                     filterType:(FWImagePickerFilterType)filterType
                      useOrigin:(BOOL)useOrigin
                     completion:(nullable void (^)(void))completion;

@end

Objective-C

@interface FWImagePickerCollectionCell : UICollectionViewCell

Objective-C

@interface FWImagePickerControllerImpl : NSObject <FWImagePickerPlugin>

Objective-C

@interface FWImagePickerPluginImpl : NSObject <FWImagePickerPlugin>

Objective-C

@interface FWImagePreviewView
    : UIView <UICollectionViewDataSource, UICollectionViewDelegateFlowLayout,
              FWZoomImageViewDelegate>

Objective-C

@interface FWImagePreviewController
    : UIViewController <UIViewControllerTransitioningDelegate>

Objective-C

@interface FWImagePreviewTransitionAnimator
    : NSObject <UIViewControllerAnimatedTransitioning>

Objective-C

@interface FWCollectionViewPagingLayout : UICollectionViewFlowLayout

Objective-C

@interface FWImagePreviewPluginImpl : NSObject <FWImagePreviewPlugin>

Objective-C

@interface FWIndicatorView
    : UIView <FWIndicatorViewPlugin, FWProgressViewPlugin>

Objective-C

@interface FWLoader<__covariant InputType, __covariant OutputType> : NSObject

Objective-C

@interface FWLocationManager : NSObject

Objective-C

@interface FWLogger : NSObject

Objective-C

@interface FWLoggerPluginImpl : NSObject <FWLoggerPlugin>

Objective-C

@interface FWMarqueeLabel : UILabel

Objective-C

@interface FWMediator : NSObject

Objective-C

@interface FWModuleBundle : NSObject

Objective-C

@interface FWClassIvarInfo : NSObject

Objective-C

@interface FWClassMethodInfo : NSObject

Objective-C

@interface FWClassPropertyInfo : NSObject

Objective-C

@interface FWClassInfo : NSObject

Objective-C

@interface FWNavigationBarAppearance : NSObject

Objective-C

@interface FWNavigator : NSObject

Objective-C

@interface FWNetworkAgent : NSObject

Objective-C

@interface FWNetworkConfig : NSObject

Objective-C

@interface FWNetworkUtils : NSObject

+ (BOOL)validateJSON:(id)json withValidator:(id)jsonValidator;

+ (void)addDoNotBackupAttribute:(NSString *)path;

+ (NSString *)md5StringFromString:(NSString *)string;

+ (NSString *)appVersionString;

+ (NSStringEncoding)stringEncodingWithRequest:(FWBaseRequest *)request;

+ (BOOL)validateResumeData:(NSData *)data;

+ (BOOL)isRequestError:(nullable NSError *)error;

@end

Objective-C

@interface FWRequest : FWBaseRequest

Objective-C

@interface FWNetworkReachabilityManager : NSObject

Objective-C

@interface FWPageControl : UIControl

Objective-C

@interface FWDotView : UIView <FWDotViewProtocol>

@property (nonatomic, strong) UIColor *dotColor;

@property (nonatomic, strong) UIColor *currentDotColor;

@property (nonatomic, assign) BOOL isAnimated;

@end

Objective-C

@interface FWBorderDotView : FWDotView

@end

Objective-C

@interface FWPasscodeFlowLayout : UICollectionViewFlowLayout

@property (assign, nonatomic) BOOL equalGap;

@property (assign, nonatomic) NSInteger itemNum;

@property (assign, nonatomic) CGFloat minLineSpacing;

- (void)updateLineSpacing;

@end

Objective-C

@interface FWPasscodeLineView : UIView

@property (strong, nonatomic) UIView    *lineView;
@property (assign, nonatomic) BOOL      selected;

/**
 下划线颜色，未选中状态，且没有填充文字时。默认：[UIColor colorWithRed:49/255.0 green:51/255.0 blue:64/255.0 alpha:1]
 */
@property (copy, nonatomic) UIColor *underlineColorNormal;

/**
 下划线颜色，选中状态时。默认：[UIColor colorWithRed:49/255.0 green:51/255.0 blue:64/255.0 alpha:1]
 */
@property (copy, nonatomic) UIColor *underlineColorSelected;

/**
 下划线颜色，未选中状态，且有填充文字时。默认：[UIColor colorWithRed:49/255.0 green:51/255.0 blue:64/255.0 alpha:1]
 */
@property (copy, nonatomic) UIColor *underlineColorFilled;

/**
 选择状态改变时回调
 */
@property (nullable, copy, nonatomic) void(^selectChangeBlock)(FWPasscodeLineView *lineView, BOOL selected);

- (instancetype)initWithFrame:(CGRect)frame UNAVAILABLE_ATTRIBUTE;

@end

Objective-C

@interface FWPasscodeSecrectImageView : UIView

@property (strong, nonatomic) UIImage   *image;
@property (assign, nonatomic) CGFloat   imageWidth;
@property (assign, nonatomic) CGFloat   imageHeight;

@end

Objective-C

@interface FWPasscodeCellProperty : NSObject <NSCopying>

#pragma mark - UI
/**
 cell边框宽度，默认：0.5
 */
@property (assign, nonatomic) CGFloat borderWidth;

/**
 cell边框颜色，未选中状态时。默认：[UIColor colorWithRed:228/255.0 green:228/255.0 blue:228/255.0 alpha:1]
 */
@property (copy, nonatomic) UIColor *cellBorderColorNormal;

/**
 cell边框颜色，选中状态时。默认：[UIColor colorWithRed:255/255.0 green:70/255.0 blue:62/255.0 alpha:1]
 */
@property (copy, nonatomic) UIColor *cellBorderColorSelected;

/**
 cell边框颜色，无填充文字，未选中状态时。默认：与cellBorderColorFilled相同
 */
@property (copy, nonatomic) UIColor *__nullable cellBorderColorFilled;

/**
 cell背景颜色，无填充文字，未选中状态时。默认：[UIColor whiteColor]
 */
@property (copy, nonatomic) UIColor *cellBgColorNormal;

/**
 cell背景颜色，选中状态时。默认：[UIColor whiteColor]
 */
@property (copy, nonatomic) UIColor *cellBgColorSelected;

/**
 cell背景颜色，填充文字后，未选中状态时。默认：与cellBgColorFilled相同
 */
@property (copy, nonatomic) UIColor *__nullable cellBgColorFilled;

/**
 光标颜色。默认： [UIColor colorWithRed:255/255.0 green:70/255.0 blue:62/255.0 alpha:1]
 */
@property (copy, nonatomic) UIColor *cellCursorColor;

/**
 光标宽度。默认： 2
 */
@property (assign, nonatomic) CGFloat cellCursorWidth;

/**
 光标高度。默认： 32
 */
@property (assign, nonatomic) CGFloat cellCursorHeight;

/**
 圆角。默认： 4
 */
@property (assign, nonatomic) CGFloat cornerRadius;



#pragma mark - line
/**
 显示下划线。默认： NO
 */
@property (assign, nonatomic) BOOL showLine;



#pragma mark - label
/**
 字体/字号。默认：[UIFont systemFontOfSize:20];
 */
@property (copy, nonatomic) UIFont *cellFont;

/**
 字体颜色。默认：[UIColor blackColor];
 */
@property (copy, nonatomic) UIColor *cellTextColor;



#pragma mark - Security
/**
 是否密文显示。默认：NO
 */
@property (assign, nonatomic) BOOL showSecurity;

/**
 密文符号。默认：✱
 说明：只有showSecurity=YES时，有效
 */
@property (copy, nonatomic) NSString *securitySymbol;

/**
 保存当前显示的字符，若想一次性修改所有输入值，请使用reloadInputString方法
 禁止修改该值！！！（除非你知道该怎么使用它。）
 */
@property (copy, nonatomic, readonly) NSString *originValue;
- (void)customOriginValue:(NSString *)originValue;

/**
 密文类型，默认：FWPasscodeSecurityTypeSymbol
 类型说明：
 FWPasscodeSecurityTypeSymbol 符号类型，根据securitySymbol，originValue的内容来显示
 FWPasscodeSecurityTypeView 自定义View类型，可以自定义密文状态下的图片，View
 */
@property (assign, nonatomic) FWPasscodeSecurityType securityType;



#pragma mark - Placeholder
/**
 占位符默认填充值
 禁止修改该值！！！（除非你知道该怎么使用它。）
 */
@property (strong, nonatomic) NSString  *__nullable cellPlaceholderText;

/**
 占位符字体颜色，默认：[UIColor colorWithRed:114/255.0 green:126/255.0 blue:124/255.0 alpha:0.3];
 */
@property (copy, nonatomic) UIColor *cellPlaceholderTextColor;

/**
 占位符字体/字号，默认：[UIFont systemFontOfSize:20];
 */
@property (copy, nonatomic) UIFont *cellPlaceholderFont;



#pragma mark - Block
/**
 自定义密文View回调
 */
@property (copy, nonatomic) UIView *_Nonnull(^customSecurityViewBlock)(void);
/**
 自定义下划线回调
 */
@property (copy, nonatomic) FWPasscodeLineView *_Nonnull(^customLineViewBlock)(void);
/**
 自定义阴影回调
 */
@property (copy, nonatomic, nullable) void(^configCellShadowBlock)(CALayer *layer);

@property (assign, nonatomic) NSInteger index;

@end

Objective-C

@interface FWPasscodeCell : UICollectionViewCell

/**
 cursor, You should not use these properties, unless you know what you are doing.
 */
@property (strong, nonatomic) UIView *cursorView;
@property (assign, nonatomic) BOOL showCursor;

/**
 cellProperty, You should not use these properties, unless you know what you are doing.
 */
@property (strong, nonatomic) FWPasscodeCellProperty *cellProperty;

@end

Objective-C

@interface FWPasscodeView : UIView

Objective-C

@interface FWPlayerCacheLoaderManager : NSObject <AVAssetResourceLoaderDelegate>

@property (nonatomic, weak, nullable) id<FWPlayerCacheLoaderManagerDelegate> delegate;

/**
 Normally you no need to call this method to clean cache. Cache cleaned after AVPlayer delloc.
 If you have a singleton AVPlayer then you need call this method to clean cache at suitable time.
 */
- (void)cleanCache;

/**
 Cancel all downloading loaders.
 */
- (void)cancelLoaders;

+ (NSURL *)assetURLWithURL:(NSURL *)url;

- (AVURLAsset *)URLAssetWithURL:(NSURL *)url;
- (AVPlayerItem *)playerItemWithURL:(NSURL *)url;

@end

Objective-C

@interface FWPlayerCacheLoader : NSObject

@property (nonatomic, strong, readonly) NSURL *url;
@property (nonatomic, weak) id<FWPlayerCacheLoaderDelegate> delegate;

- (instancetype)initWithURL:(NSURL *)url;

- (void)addRequest:(AVAssetResourceLoadingRequest *)request;
- (void)removeRequest:(AVAssetResourceLoadingRequest *)request;

- (void)cancel;

@end

Objective-C

@interface FWPlayerCacheDownloaderStatus : NSObject

+ (instancetype)shared;

- (void)addURL:(NSURL *)url;
- (void)removeURL:(NSURL *)url;

/**
 return YES if downloading the url source
 */
- (BOOL)containsURL:(NSURL *)url;
- (NSSet *)urls;

@end

Objective-C

@interface FWPlayerCacheDownloader : NSObject

- (instancetype)initWithURL:(NSURL *)url cacheWorker:(FWPlayerCacheWorker *)cacheWorker;
@property (nonatomic, strong, readonly) NSURL *url;
@property (nonatomic, weak) id<FWPlayerCacheDownloaderDelegate> delegate;
@property (nonatomic, strong) FWPlayerCacheContentInfo *info;
@property (nonatomic, assign) BOOL saveToCache;

- (void)downloadTaskFromOffset:(unsigned long long)fromOffset
                        length:(NSUInteger)length
                         toEnd:(BOOL)toEnd;
- (void)downloadFromStartToEnd;

- (void)cancel;

@end

Objective-C

@interface FWPlayerCacheRequestWorker : NSObject

- (instancetype)initWithMediaDownloader:(FWPlayerCacheDownloader *)mediaDownloader resourceLoadingRequest:(AVAssetResourceLoadingRequest *)request;

@property (nonatomic, weak) id<FWPlayerCacheRequestWorkerDelegate> delegate;

@property (nonatomic, strong, readonly) AVAssetResourceLoadingRequest *request;

- (void)startWork;
- (void)cancel;
- (void)finish;

@end

Objective-C

@interface FWPlayerCacheContentInfo : NSObject <NSCoding>

@property (nonatomic, copy) NSString *contentType;
@property (nonatomic, assign) BOOL byteRangeAccessSupported;
@property (nonatomic, assign) unsigned long long contentLength;
@property (nonatomic) unsigned long long downloadedContentLength;

@end

Objective-C

@interface FWPlayerCacheAction : NSObject

- (instancetype)initWithActionType:(FWPlayerCacheAtionType)actionType range:(NSRange)range;

@property (nonatomic) FWPlayerCacheAtionType actionType;
@property (nonatomic) NSRange range;

@end

Objective-C

@interface FWPlayerCacheConfiguration : NSObject <NSCopying>

+ (NSString *)configurationFilePathForFilePath:(NSString *)filePath;

+ (instancetype)configurationWithFilePath:(NSString *)filePath;

@property (nonatomic, copy, readonly) NSString *filePath;
@property (nonatomic, strong) FWPlayerCacheContentInfo *contentInfo;
@property (nonatomic, strong) NSURL *url;

- (NSArray<NSValue *> *)cacheFragments;

/**
 *  cached progress
 */
@property (nonatomic, readonly) float progress;
@property (nonatomic, readonly) long long downloadedBytes;
@property (nonatomic, readonly) float downloadSpeed; // kb/s

#pragma mark - update API

- (void)save;
- (void)addCacheFragment:(NSRange)fragment;

/**
 *  Record the download speed
 */
- (void)addDownloadedBytes:(long long)bytes spent:(NSTimeInterval)time;

+ (BOOL)createAndSaveDownloadedConfigurationForURL:(NSURL *)url error:(NSError **)error;

@end

Objective-C

@interface FWPlayerCacheManager : NSObject

+ (void)setCacheDirectory:(NSString *)cacheDirectory;
+ (NSString *)cacheDirectory;


/**
 How often trigger `FWPlayerCacheManagerDidUpdateCacheNotification` notification

 @param interval Minimum interval
 */
+ (void)setCacheUpdateNotifyInterval:(NSTimeInterval)interval;
+ (NSTimeInterval)cacheUpdateNotifyInterval;

+ (NSString *)cachedFilePathForURL:(NSURL *)url;
+ (FWPlayerCacheConfiguration *)cacheConfigurationForURL:(NSURL *)url;

+ (void)setFileNameRules:(NSString *(^)(NSURL *url))rules;


/**
 Calculate cached files size

 @param error If error not empty, calculate failed
 @return files size, respresent by `byte`, if error occurs, return -1
 */
+ (unsigned long long)calculateCachedSizeWithError:(NSError **)error;
+ (void)cleanAllCacheWithError:(NSError **)error;
+ (void)cleanCacheForURL:(NSURL *)url error:(NSError **)error;


/**
 Useful when you upload a local file to the server

 @param filePath local file path
 @param url remote resource url
 @param error On input, a pointer to an error object. If an error occurs, this pointer is set to an actual error object containing the error information.
 */
+ (BOOL)addCacheFile:(NSString *)filePath forURL:(NSURL *)url error:(NSError **)error;

@end

Objective-C

@interface FWPlayerCacheSessionManager : NSObject

@property (nonatomic, strong, readonly) NSOperationQueue *downloadQueue;

+ (instancetype)shared;

@end

Objective-C

@interface FWPlayerCacheWorker : NSObject

- (instancetype)initWithURL:(NSURL *)url;

@property (nonatomic, strong, readonly) FWPlayerCacheConfiguration *cacheConfiguration;
@property (nonatomic, strong, readonly) NSError *setupError; // Create fileHandler error, can't save/use cache

- (void)cacheData:(NSData *)data forRange:(NSRange)range error:(NSError **)error;
- (NSArray<FWPlayerCacheAction *> *)cachedDataActionsForRange:(NSRange)range;
- (NSData *)cachedDataForRange:(NSRange)range error:(NSError **)error;

- (void)setContentInfo:(FWPlayerCacheContentInfo *)contentInfo error:(NSError **)error;

- (void)save;

- (void)startWritting;
- (void)finishWritting;

@end