TakePhoto 简介

TakePhoto 是一款用于在Android设备上获取照片（拍照或从相册、文件中选择）、裁剪图片、压缩图片的开源工具库，目前最新版本3.0.0。

3.0以下版本及API说明，详见TakePhoto2.0+。

V3.0

• 支持通过相机拍照获取图片
• 支持从相册选择图片
• 支持从文件选择图片
• 支持批量图片选取
• 支持图片压缩以及批量图片压缩
• 支持图片裁切以及批量图片裁切
• 支持照片旋转角度自动纠正
• 支持自动权限管理(无需关心SD卡及摄像头权限等问题)
• 支持对裁剪及压缩参数个性化配置
• 提供自带裁剪工具(可选)
• 支持智能选取及裁剪异常处理
• 支持因拍照Activity被回收后的自动恢复
• 支持Android7.0

GitHub地址： https://github.com/crazycodeboy/TakePhoto

目录

• 安装说明
• 演示
• 使用说明
• API
• 贡献

安装说明

Gradle:

compile 'com.jph.takephoto:takephoto_library:3.0.0'

Maven:

<dependency>
  <groupId>com.jph.takephoto</groupId>
  <artifactId>takephoto_library</artifactId>
  <version>3.0.0</version>
  <type>pom</type>
</dependency>

演示
运行效果图：



使用说明
使用TakePhoto有以下两种方式：

方式一：通过继承的方式

• 继承TakePhotoActivity、TakePhotoFragmentActivity、TakePhotoFragment三者之一。
• 通过getTakePhoto()获取TakePhoto实例进行相关操作。
• 重写以下方法获取结果

 void takeSuccess(TResult result);
 void takeFail(TResult result,String msg);
 void takeCancel();

此方式使用简单，满足的大部分的使用需求，具体使用详见simple。如果通过继承的方式无法满足实际项目的使用，可以通过下面介绍的方式。

方式二：通过组装的方式

可参照：TakePhotoActivity，以下为主要步骤：

1. 实现TakePhoto.TakeResultListener,InvokeListener接口。
2. 在 onCreate,onActivityResult,onSaveInstanceState方法中调用TakePhoto对用的方法。
3. 重写onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults)，添加如下代码。

@Override
 public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults) {
     super.onRequestPermissionsResult(requestCode, permissions, grantResults);
     //以下代码为处理Android6.0、7.0动态权限所需
     TPermissionType type=PermissionManager.onRequestPermissionsResult(requestCode,permissions,grantResults);
     PermissionManager.handlePermissionsResult(this,type,invokeParam,this);
 }

4. 重写TPermissionType invoke(InvokeParam invokeParam)方法，添加如下代码：

@Override
 public TPermissionType invoke(InvokeParam invokeParam) {
     TPermissionType type=PermissionManager.checkPermission(TContextWrap.of(this),invokeParam.getMethod());
     if(TPermissionType.WAIT.equals(type)){
         this.invokeParam=invokeParam;
     }
     return type;
 }

5. 添加如下代码获取TakePhoto实例：

/**
  *  获取TakePhoto实例
  * @return
  */
 public TakePhoto getTakePhoto(){
     if (takePhoto==null){
         takePhoto= (TakePhoto) TakePhotoInvocationHandler.of(this).bind(new TakePhotoImpl(this,this));
     }
     return takePhoto;
 }

API

获取图片
TakePhoto提供拍照，从相册选择，从文件中选择三种方式获取图片。

/**
 * 从文件中获取图片（不裁剪）
 */
void onPickFromDocuments();
/**
 * 从相册中获取图片（不裁剪）
 */
void onPickFromGallery();
/**
 * 从相机获取图片(不裁剪)
 * @param outPutUri 图片保存的路径
 */
void onPickFromCapture(Uri outPutUri);
/**
 * 图片多选
 * @param limit 最多选择图片张数的限制
 **/
void onPickMultiple(int limit);

以上三种方式均提供对应的裁剪API，详见：裁剪图片。

注：
由于不同Android Rom厂商对系统有不同程度的定制，有可能导致某种选择图片的方式不支持，所以为了提高TakePhoto的兼容性，当某种选的图片的方式不支持时，TakePhoto会自动切换成使用另一种选择图片的方式进行图片选择。

裁剪图片

API
TakePhoto支持对图片进行裁剪，无论是拍照的照片,还是从相册、文件中选择的图片。你只需要调用TakePhoto的相应方法即可：

/**
 * 从相机获取图片并裁剪
 * @param outPutUri 图片裁剪之后保存的路径
 * @param options 裁剪配置             
 */
void onPickFromCaptureWithCrop(Uri outPutUri, CropOptions options);
/**
 * 从相册中获取图片并裁剪
 * @param outPutUri 图片裁剪之后保存的路径
 * @param options 裁剪配置
 */
void onPickFromGalleryWithCrop(Uri outPutUri, CropOptions options);
/**
 * 从文件中获取图片并裁剪
 * @param outPutUri 图片裁剪之后保存的路径
 * @param options 裁剪配置
 */
void onPickFromDocumentsWithCrop(Uri outPutUri, CropOptions options);
/**
 * 图片多选，并裁切
 * @param limit 最多选择图片张数的限制
 * @param options  裁剪配置
 * */
void onPickMultipleWithCrop(int limit, CropOptions options);

对指定图片进行裁剪
另外，TakePhoto也支持你对指定图片进行裁剪：

/**
 * 裁剪图片
 * @param imageUri 要裁剪的图片
 * @param outPutUri 图片裁剪之后保存的路径
 * @param options 裁剪配置
 */
void onCrop(Uri imageUri, Uri outPutUri, CropOptions options)throws TException;
/**
 * 裁剪多张图片
 * @param multipleCrop 要裁切的图片的路径以及输出路径
 * @param options 裁剪配置
 */
void onCrop(MultipleCrop multipleCrop, CropOptions options)throws TException;

CropOptions

CropOptions是用于裁剪的配置类，通过它你可以对图片的裁剪比例，最大输出大小，以及是否使用TakePhoto自带的裁剪工具进行裁剪等，进行个性化配置。

 CropOptions cropOptions=new CropOptions.Builder().setAspectX(1).setAspectY(1).setWithOwnCrop(true).create();  
 getTakePhoto().onPickFromDocumentsWithCrop(imageUri,cropOptions);  
 //或  
 getTakePhoto().onCrop(imageUri,outPutUri,cropOptions);

注：
由于不同Android Rom厂商对系统有不同程度的定制，有可能系统中没有自带或第三方的裁剪工具，所以为了提高TakePhoto的兼容性，当系统中没有自带或第三方裁剪工具时，TakePhoto会自动切换到使用TakePhoto自带的裁剪工具进行裁剪。

压缩图片

你可以选择是否对图片进行压缩处理，你只需要告诉它你是否要启用压缩功能以及CompressConfig即可。

 /**
  * 启用图片压缩
  * @param config 压缩图片配置
  * @param showCompressDialog 压缩时是否显示进度对话框
  * @return
  */
 void onEnableCompress(CompressConfig config,boolean showCompressDialog);

TakePhoto takePhoto=getTakePhoto();
takePhoto.onEnableCompress(compressConfig,true);
takePhoto.onPickFromGallery();

如果你启用了图片压缩，TakePhoto会使用CompressImage对图片进行压缩处理，CompressImage目前支持对图片的尺寸以及图片的质量进行压缩。默认情况下，CompressImage开启了尺寸与质量双重压缩。

对指定图片进行压缩
另外，你也可以对指定图片进行压缩：

new CompressImageImpl(compressConfig,result.getImages(), new CompressImage.CompressListener() {
    @Override
    public void onCompressSuccess(ArrayList<TImage> images) {
        //图片压缩成功
    }
    @Override
    public void onCompressFailed(ArrayList<TImage> images, String msg) {
        //图片压缩失败
    }
}).compress();

CompressConfig

CompressConfig是用于图片压缩的配置类，你可以通过CompressConfig.Builder对图片压缩后的尺寸以及质量进行相关设置。如果你想改变压缩的方式可以通过CompressConfig.Builder进行相关设置。

CompressConfig compressConfig=new CompressConfig.Builder().setMaxSize(50*1024).setMaxPixel(800).create();

兼容性

Android6.0
由于Android6.0新增了”运行时权限控制(Runtime Permissions)”，为了应对这一改变，TakePhoto加入和自动权限管理，当TakePhoto检测到需要权限时，TakePhoto会自动申请权限，所以小伙伴们不用担心权限的使用问题。

Android7.0
在Android N中，Android 框架执行了 StrictMode，应用间共享文件和以前也有所区别。为了适配Android7.0的改变，同时也为了方便大家使用TakePhoto，TakePhoto会自动根据手机的Android版本自行适配，小伙伴们依旧可以向TakePhoto传递Uri imageUri = Uri.fromFile(file);类型的Uri而不用担心兼容性问题。

TakePhoto在深度兼容性方面的测试



获取更高的兼容性
TakePhoto是基于Android官方标准API编写的，适配了目前市场上主流的Rom。如果你在使用过程中发现了适配问题，可以提交Issues。

1. 为适配部分手机拍照时会回收Activity，TakePhoto在onSaveInstanceState与 onCreate做了相应的恢复处理。
2. 为适配部分手机拍照或从相册选择图片时屏幕方向会发生转变,从而导致拍照失败的问题，可以在AndroidManifest.xml中对使用了TakePhoto的Activity添加android:configChanges=”orientation|keyboardHidden|screenSize”配置。

<activity
    android:name=".MainActivity"
    android:screenOrientation="portrait"
    android:configChanges="orientation|keyboardHidden|screenSize"
    android:label="@string/app_name" >
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
</activity>

贡献
如果你在使用TakePhoto中遇到任何问题可以提Issues出来。另外欢迎大家为TakePhoto贡献智慧，欢迎大家Fork and Pull requests。

最后
既然来了，留下个喜欢再走吧，鼓励我继续创作(^_^)∠※