//
|
// TZImageManager.h
|
// TZImagePickerController
|
//
|
// Created by 谭真 on 16/1/4.
|
// Copyright © 2016年 谭真. All rights reserved.
|
// 图片资源获取管理类
|
|
#import <Foundation/Foundation.h>
|
#import <UIKit/UIKit.h>
|
#import <AVFoundation/AVFoundation.h>
|
#import <Photos/Photos.h>
|
#import "TZAssetModel.h"
|
|
@class TZAlbumModel,TZAssetModel;
|
@protocol TZImagePickerControllerDelegate;
|
@interface TZImageManager : NSObject
|
|
@property (nonatomic, strong) PHCachingImageManager *cachingImageManager;
|
|
+ (instancetype)manager NS_SWIFT_NAME(default());
|
+ (void)deallocManager;
|
|
@property (weak, nonatomic) id<TZImagePickerControllerDelegate> pickerDelegate;
|
|
@property (nonatomic, assign) BOOL shouldFixOrientation;
|
|
@property (nonatomic, assign) BOOL isPreviewNetworkImage;
|
|
/// Default is 600px / 默认600像素宽
|
@property (nonatomic, assign) CGFloat photoPreviewMaxWidth;
|
/// The pixel width of output image, Default is 828px / 导出图片的宽度，默认828像素宽
|
@property (nonatomic, assign) CGFloat photoWidth;
|
|
/// Default is 4, Use in photos collectionView in TZPhotoPickerController
|
/// 默认4列, TZPhotoPickerController中的照片collectionView
|
@property (nonatomic, assign) NSInteger columnNumber;
|
|
/// Sort photos ascending by modificationDate，Default is YES
|
/// 对照片排序，按修改时间升序，默认是YES。如果设置为NO,最新的照片会显示在最前面，内部的拍照按钮会排在第一个
|
@property (nonatomic, assign) BOOL sortAscendingByModificationDate;
|
|
/// Minimum selectable photo width, Default is 0
|
/// 最小可选中的图片宽度，默认是0，小于这个宽度的图片不可选中
|
@property (nonatomic, assign) NSInteger minPhotoWidthSelectable;
|
@property (nonatomic, assign) NSInteger minPhotoHeightSelectable;
|
@property (nonatomic, assign) BOOL hideWhenCanNotSelect;
|
|
/// Return YES if Authorized 返回YES如果得到了授权
|
- (BOOL)authorizationStatusAuthorized;
|
- (void)requestAuthorizationWithCompletion:(void (^)(void))completion;
|
- (BOOL)isPHAuthorizationStatusLimited;
|
|
/// Get Album 获得相册/相册数组
|
- (void)getCameraRollAlbumWithFetchAssets:(BOOL)needFetchAssets completion:(void (^)(TZAlbumModel *model))completion;
|
- (void)getCameraRollAlbum:(BOOL)allowPickingVideo allowPickingImage:(BOOL)allowPickingImage needFetchAssets:(BOOL)needFetchAssets completion:(void (^)(TZAlbumModel *model))completion __attribute__((deprecated("Use -getCameraRollAlbumWithFetchAssets:completion:. You can config allowPickingImage、allowPickingVideo by TZImagePickerConfig")));
|
- (void)getAllAlbums:(BOOL)allowPickingVideo allowPickingImage:(BOOL)allowPickingImage needFetchAssets:(BOOL)needFetchAssets completion:(void (^)(NSArray<TZAlbumModel *> *models))completion __attribute__((deprecated("Use -getAllAlbumsWithFetchAssets:completion:. You can config allowPickingImage、allowPickingVideo by TZImagePickerConfig")));
|
- (void)getAllAlbumsWithFetchAssets:(BOOL)needFetchAssets completion:(void (^)(NSArray<TZAlbumModel *> *models))completion;
|
|
/// Get Assets 获得Asset数组
|
- (void)getAssetsFromFetchResult:(PHFetchResult *)result completion:(void (^)(NSArray<TZAssetModel *> *models))completion;
|
- (void)getAssetsFromFetchResult:(PHFetchResult *)result allowPickingVideo:(BOOL)allowPickingVideo allowPickingImage:(BOOL)allowPickingImage completion:(void (^)(NSArray<TZAssetModel *> *models))completion __attribute__((deprecated("Use -getAssetsFromFetchResult:completion:. You can config allowPickingImage、allowPickingVideo by TZImagePickerConfig")));
|
- (void)getAssetFromFetchResult:(PHFetchResult *)result atIndex:(NSInteger)index allowPickingVideo:(BOOL)allowPickingVideo allowPickingImage:(BOOL)allowPickingImage completion:(void (^)(TZAssetModel *model))completion __attribute__((deprecated("Use -getAssetFromFetchResult:atIndex:completion:. You can config allowPickingImage、allowPickingVideo by TZImagePickerConfig")));
|
- (void)getAssetFromFetchResult:(PHFetchResult *)result atIndex:(NSInteger)index completion:(void (^)(TZAssetModel *model))completion;
|
|
/// Get photo 获得照片
|
- (PHImageRequestID)getPostImageWithAlbumModel:(TZAlbumModel *)model completion:(void (^)(UIImage *postImage))completion;
|
|
- (PHImageRequestID)getPhotoWithAsset:(PHAsset *)asset completion:(void (^)(UIImage *photo,NSDictionary *info,BOOL isDegraded))completion;
|
- (PHImageRequestID)getPhotoWithAsset:(PHAsset *)asset photoWidth:(CGFloat)photoWidth completion:(void (^)(UIImage *photo,NSDictionary *info,BOOL isDegraded))completion;
|
- (PHImageRequestID)getPhotoWithAsset:(PHAsset *)asset completion:(void (^)(UIImage *photo,NSDictionary *info,BOOL isDegraded))completion progressHandler:(void (^)(double progress, NSError *error, BOOL *stop, NSDictionary *info))progressHandler networkAccessAllowed:(BOOL)networkAccessAllowed;
|
- (PHImageRequestID)getPhotoWithAsset:(PHAsset *)asset photoWidth:(CGFloat)photoWidth completion:(void (^)(UIImage *photo,NSDictionary *info,BOOL isDegraded))completion progressHandler:(void (^)(double progress, NSError *error, BOOL *stop, NSDictionary *info))progressHandler networkAccessAllowed:(BOOL)networkAccessAllowed;
|
- (PHImageRequestID)requestImageDataForAsset:(PHAsset *)asset completion:(void (^)(NSData *imageData, NSString *dataUTI, UIImageOrientation orientation, NSDictionary *info))completion progressHandler:(void (^)(double progress, NSError *error, BOOL *stop, NSDictionary *info))progressHandler;
|
|
/// Get full Image 获取原图
|
/// 如下两个方法completion一般会调多次，一般会先返回缩略图，再返回原图(详见方法内部使用的系统API的说明)，如果info[PHImageResultIsDegradedKey] 为 YES，则表明当前返回的是缩略图，否则是原图。
|
- (PHImageRequestID)getOriginalPhotoWithAsset:(PHAsset *)asset completion:(void (^)(UIImage *photo,NSDictionary *info))completion;
|
- (PHImageRequestID)getOriginalPhotoWithAsset:(PHAsset *)asset newCompletion:(void (^)(UIImage *photo,NSDictionary *info,BOOL isDegraded))completion;
|
- (PHImageRequestID)getOriginalPhotoWithAsset:(PHAsset *)asset progressHandler:(void (^)(double progress, NSError *error, BOOL *stop, NSDictionary *info))progressHandler newCompletion:(void (^)(UIImage *photo,NSDictionary *info,BOOL isDegraded))completion;
|
// 该方法中，completion只会走一次
|
- (PHImageRequestID)getOriginalPhotoDataWithAsset:(PHAsset *)asset completion:(void (^)(NSData *data,NSDictionary *info,BOOL isDegraded))completion;
|
- (PHImageRequestID)getOriginalPhotoDataWithAsset:(PHAsset *)asset progressHandler:(void (^)(double progress, NSError *error, BOOL *stop, NSDictionary *info))progressHandler completion:(void (^)(NSData *data,NSDictionary *info,BOOL isDegraded))completion;
|
|
/// Get Image For VideoURL
|
- (UIImage *)getImageWithVideoURL:(NSURL *)videoURL;
|
|
/// Save photo 保存照片
|
- (void)savePhotoWithImage:(UIImage *)image completion:(void (^)(PHAsset *asset, NSError *error))completion;
|
- (void)savePhotoWithImage:(UIImage *)image location:(CLLocation *)location completion:(void (^)(PHAsset *asset, NSError *error))completion;
|
- (void)savePhotoWithImage:(UIImage *)image meta:(NSDictionary *)meta location:(CLLocation *)location completion:(void (^)(PHAsset *asset, NSError *error))completion;
|
|
/// Save video 保存视频
|
- (void)saveVideoWithUrl:(NSURL *)url completion:(void (^)(PHAsset *asset, NSError *error))completion;
|
- (void)saveVideoWithUrl:(NSURL *)url location:(CLLocation *)location completion:(void (^)(PHAsset *asset, NSError *error))completion;
|
|
/// Get video 获得视频
|
- (void)getVideoWithAsset:(PHAsset *)asset completion:(void (^)(AVPlayerItem * playerItem, NSDictionary * info))completion;
|
- (void)getVideoWithAsset:(PHAsset *)asset progressHandler:(void (^)(double progress, NSError *error, BOOL *stop, NSDictionary *info))progressHandler completion:(void (^)(AVPlayerItem *, NSDictionary *))completion;
|
|
/// Export video 导出视频 presetName: 预设名字，默认值是AVAssetExportPreset640x480
|
- (void)getVideoOutputPathWithAsset:(PHAsset *)asset success:(void (^)(NSString *outputPath))success failure:(void (^)(NSString *errorMessage, NSError *error))failure;
|
- (void)getVideoOutputPathWithAsset:(PHAsset *)asset presetName:(NSString *)presetName success:(void (^)(NSString *outputPath))success failure:(void (^)(NSString *errorMessage, NSError *error))failure;
|
- (void)getVideoOutputPathWithAsset:(PHAsset *)asset presetName:(NSString *)presetName timeRange:(CMTimeRange)timeRange success:(void (^)(NSString *outputPath))success failure:(void (^)(NSString *errorMessage, NSError *error))failure;
|
/// 新的导出视频API，解决iOS14 iCloud视频导出失败的问题，未大量测试，请大家多多测试，有问题群里反馈
|
- (void)requestVideoOutputPathWithAsset:(PHAsset *)asset presetName:(NSString *)presetName success:(void (^)(NSString *outputPath))success failure:(void (^)(NSString *errorMessage, NSError *error))failure;
|
/// 得到视频原始文件地址
|
- (void)requestVideoURLWithAsset:(PHAsset *)asset success:(void (^)(NSURL *videoURL))success failure:(void (^)(NSDictionary* info))failure;
|
|
/// Get photo bytes 获得一组照片的大小
|
- (void)getPhotosBytesWithArray:(NSArray *)photos completion:(void (^)(NSString *totalBytes))completion;
|
|
- (BOOL)isCameraRollAlbum:(PHAssetCollection *)metadata;
|
|
/// 检查照片大小是否满足最小要求
|
- (BOOL)isPhotoSelectableWithAsset:(PHAsset *)asset;
|
|
/// 检查照片能否被选中
|
- (BOOL)isAssetCannotBeSelected:(PHAsset *)asset;
|
|
/// 修正图片转向
|
- (UIImage *)fixOrientation:(UIImage *)aImage;
|
|
/// 获取asset的资源类型
|
- (TZAssetModelMediaType)getAssetType:(PHAsset *)asset;
|
/// 缩放图片至新尺寸
|
- (UIImage *)scaleImage:(UIImage *)image toSize:(CGSize)size;
|
|
/// 判断asset是否是视频
|
- (BOOL)isVideo:(PHAsset *)asset;
|
|
/// for TZImagePreviewController
|
- (NSString *)getNewTimeFromDurationSecond:(NSInteger)duration;
|
|
- (TZAssetModel *)createModelWithAsset:(PHAsset *)asset;
|
|
@end
|
|
//@interface TZSortDescriptor : NSSortDescriptor
|
//
|
//@end
|
