DCTZImageManager.h 7.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123
  1. //
  2. // TZImageManager.h
  3. // TZImagePickerController
  4. //
  5. // Created by 谭真 on 16/1/4.
  6. // Copyright © 2016年 谭真. All rights reserved.
  7. // 图片资源获取管理类
  8. #import <Foundation/Foundation.h>
  9. #import <UIKit/UIKit.h>
  10. #import <AVFoundation/AVFoundation.h>
  11. #import <Photos/Photos.h>
  12. #import "DCTZAssetModel.h"
  13. @class DCTZAlbumModel,DCTZAssetModel;
  14. @protocol DCTZImagePickerControllerDelegate;
  15. @interface DCTZImageManager : NSObject
  16. @property (nonatomic, strong) PHCachingImageManager *cachingImageManager;
  17. + (instancetype)manager NS_SWIFT_NAME(default());
  18. + (void)deallocManager;
  19. @property (weak, nonatomic) id<DCTZImagePickerControllerDelegate> pickerDelegate;
  20. @property (nonatomic, assign) BOOL shouldFixOrientation;
  21. /// Default is 600px / 默认600像素宽
  22. @property (nonatomic, assign) CGFloat photoPreviewMaxWidth;
  23. /// The pixel width of output image, Default is 828px / 导出图片的宽度,默认828像素宽
  24. @property (nonatomic, assign) CGFloat photoWidth;
  25. /// Default is 4, Use in photos collectionView in TZPhotoPickerController
  26. /// 默认4列, TZPhotoPickerController中的照片collectionView
  27. @property (nonatomic, assign) NSInteger columnNumber;
  28. /// Sort photos ascending by modificationDate,Default is YES
  29. /// 对照片排序,按修改时间升序,默认是YES。如果设置为NO,最新的照片会显示在最前面,内部的拍照按钮会排在第一个
  30. @property (nonatomic, assign) BOOL sortAscendingByModificationDate;
  31. /// Minimum selectable photo width, Default is 0
  32. /// 最小可选中的图片宽度,默认是0,小于这个宽度的图片不可选中
  33. @property (nonatomic, assign) NSInteger minPhotoWidthSelectable;
  34. @property (nonatomic, assign) NSInteger minPhotoHeightSelectable;
  35. @property (nonatomic, assign) BOOL hideWhenCanNotSelect;
  36. @property (nonatomic, assign) BOOL isSelectOriginalPhoto;
  37. /// Return YES if Authorized 返回YES如果得到了授权
  38. - (BOOL)authorizationStatusAuthorized;
  39. + (NSInteger)authorizationStatus;
  40. - (void)requestAuthorizationWithCompletion:(void (^)(void))completion;
  41. /// Get Album 获得相册/相册数组
  42. - (void)getCameraRollAlbum:(BOOL)allowPickingVideo allowPickingImage:(BOOL)allowPickingImage needFetchAssets:(BOOL)needFetchAssets completion:(void (^)(DCTZAlbumModel *model))completion;
  43. - (void)getAllAlbums:(BOOL)allowPickingVideo allowPickingImage:(BOOL)allowPickingImage needFetchAssets:(BOOL)needFetchAssets completion:(void (^)(NSArray<DCTZAlbumModel *> *models))completion;
  44. /// Get Assets 获得Asset数组
  45. - (void)getAssetsFromFetchResult:(id)result completion:(void (^)(NSArray<DCTZAssetModel *> *models))completion;
  46. - (void)getAssetsFromFetchResult:(id)result allowPickingVideo:(BOOL)allowPickingVideo allowPickingImage:(BOOL)allowPickingImage completion:(void (^)(NSArray<DCTZAssetModel *> *models))completion;
  47. - (void)getAssetFromFetchResult:(id)result atIndex:(NSInteger)index allowPickingVideo:(BOOL)allowPickingVideo allowPickingImage:(BOOL)allowPickingImage completion:(void (^)(DCTZAssetModel *model))completion;
  48. /// Get photo 获得照片
  49. - (void)getPostImageWithAlbumModel:(DCTZAlbumModel *)model completion:(void (^)(UIImage *postImage))completion;
  50. - (int32_t)getPhotoWithAsset:(id)asset completion:(void (^)(UIImage *photo,NSDictionary *info,BOOL isDegraded))completion;
  51. - (int32_t)getPhotoWithAsset:(id)asset photoWidth:(CGFloat)photoWidth completion:(void (^)(UIImage *photo,NSDictionary *info,BOOL isDegraded))completion;
  52. - (int32_t)getPhotoWithAsset:(id)asset completion:(void (^)(UIImage *photo,NSDictionary *info,BOOL isDegraded))completion progressHandler:(void (^)(double progress, NSError *error, BOOL *stop, NSDictionary *info))progressHandler networkAccessAllowed:(BOOL)networkAccessAllowed;
  53. - (int32_t)getPhotoWithAsset:(id)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;
  54. - (int32_t)requestImageDataForAsset:(id)asset completion:(void (^)(NSData *imageData, NSString *dataUTI, UIImageOrientation orientation, NSDictionary *info))completion progressHandler:(void (^)(double progress, NSError *error, BOOL *stop, NSDictionary *info))progressHandler;
  55. /// Get full Image 获取原图
  56. /// 如下两个方法completion一般会调多次,一般会先返回缩略图,再返回原图(详见方法内部使用的系统API的说明),如果info[PHImageResultIsDegradedKey] 为 YES,则表明当前返回的是缩略图,否则是原图。
  57. - (void)getOriginalPhotoWithAsset:(id)asset completion:(void (^)(UIImage *photo,NSDictionary *info))completion;
  58. - (void)getOriginalPhotoWithAsset:(id)asset newCompletion:(void (^)(UIImage *photo,NSDictionary *info,BOOL isDegraded))completion;
  59. // 该方法中,completion只会走一次
  60. - (void)getOriginalPhotoDataWithAsset:(id)asset completion:(void (^)(NSData *data,NSDictionary *info,BOOL isDegraded))completion;
  61. /// Save photo 保存照片
  62. - (void)savePhotoWithImage:(UIImage *)image completion:(void (^)(NSError *error))completion;
  63. - (void)savePhotoWithImage:(UIImage *)image location:(CLLocation *)location completion:(void (^)(NSError *error))completion;
  64. /// Save video 保存视频
  65. - (void)saveVideoWithUrl:(NSURL *)url completion:(void (^)(NSError *error))completion;
  66. - (void)saveVideoWithUrl:(NSURL *)url location:(CLLocation *)location completion:(void (^)(NSError *error))completion;
  67. /// Get video 获得视频
  68. - (void)getVideoWithAsset:(id)asset completion:(void (^)(AVPlayerItem * playerItem, NSDictionary * info))completion;
  69. - (void)getVideoWithAsset:(id)asset progressHandler:(void (^)(double progress, NSError *error, BOOL *stop, NSDictionary *info))progressHandler completion:(void (^)(AVPlayerItem *, NSDictionary *))completion;
  70. /// Export video 导出视频 presetName: 预设名字,默认值是AVAssetExportPreset640x480
  71. - (void)getVideoOutputPathWithAsset:(id)asset success:(void (^)(NSString *outputPath))success failure:(void (^)(NSString *errorMessage, NSError *error))failure;
  72. - (void)getVideoOutputPathWithAsset:(id)asset presetName:(NSString *)presetName success:(void (^)(NSString *outputPath))success failure:(void (^)(NSString *errorMessage, NSError *error))failure;
  73. /// Deprecated, Use -getVideoOutputPathWithAsset:failure:success:
  74. - (void)getVideoOutputPathWithAsset:(id)asset completion:(void (^)(NSString *outputPath))completion __attribute__((deprecated("Use -getVideoOutputPathWithAsset:failure:success:")));
  75. /// Get photo bytes 获得一组照片的大小
  76. - (void)getPhotosBytesWithArray:(NSArray *)photos completion:(void (^)(NSString *totalBytes))completion;
  77. /// Judge is a assets array contain the asset 判断一个assets数组是否包含这个asset
  78. - (BOOL)isAssetsArray:(NSArray *)assets containAsset:(id)asset;
  79. - (NSString *)getAssetIdentifier:(id)asset;
  80. - (BOOL)isCameraRollAlbum:(id)metadata;
  81. /// 检查照片大小是否满足最小要求
  82. - (BOOL)isPhotoSelectableWithAsset:(id)asset;
  83. - (CGSize)photoSizeWithAsset:(id)asset;
  84. /// 修正图片转向
  85. - (UIImage *)fixOrientation:(UIImage *)aImage;
  86. /// 获取asset的资源类型
  87. - (DCTZAssetModelMediaType)getAssetType:(id)asset;
  88. /// 缩放图片至新尺寸
  89. - (UIImage *)scaleImage:(UIImage *)image toSize:(CGSize)size;
  90. @end
  91. //@interface TZSortDescriptor : NSSortDescriptor
  92. //
  93. //@end