- Notifications
You must be signed in to change notification settings - Fork1.5k
一款用于在Android设备上获取照片（拍照或从相册、文件中选择）、裁剪图片、压缩图片的开源工具库
License
crazycodeboy/TakePhoto
Folders and files
| Name | Name | Last commit message | Last commit date | |
|---|---|---|---|---|
Repository files navigation
TakePhoto 简介
TakePhoto是一款用于在Android设备上获取照片（拍照或从相册、文件中选择）、裁剪图片、压缩图片的开源工具库，目前最新版本4.1.0。3.0以下版本及API说明，详见TakePhoto2.0+。
TakePhoto交流平台：QQ群：556387607（群1，未满）
V4.0
- 支持通过相机拍照获取图片
- 支持从相册选择图片
- 支持从文件选择图片
- 支持批量图片选取
- 支持图片压缩以及批量图片压缩
- 支持图片裁切以及批量图片裁切
- 支持照片旋转角度自动纠正
- 支持自动权限管理(无需关心SD卡及摄像头权限等问题)
- 支持对裁剪及压缩参数个性化配置
- 提供自带裁剪工具(可选)
- 支持智能选取及裁剪异常处理
- 支持因拍照Activity被回收后的自动恢复
- 支持Android8.1
- +支持多种压缩工具
- +支持多种图片选择工具
GitHub地址：https://github.com/crazycodeboy/TakePhoto
Gradle:
compile'com.jph.takephoto:takephoto_library:4.1.0'Maven:
<dependency><groupId>com.jph.takephoto</groupId><artifactId>takephoto_library</artifactId><version>4.1.0</version><type>pom</type></dependency>
运行效果图：
方式一：通过继承的方式
- 继承
TakePhotoActivity、TakePhotoFragmentActivity、TakePhotoFragment三者之一。 - 通过
getTakePhoto()获取TakePhoto实例进行相关操作。 - 重写以下方法获取结果
voidtakeSuccess(TResultresult);voidtakeFail(TResultresult,Stringmsg);voidtakeCancel();
此方式使用简单，满足的大部分的使用需求，具体使用详见simple。如果通过继承的方式无法满足实际项目的使用，可以通过下面介绍的方式。
方式二：通过组装的方式
可参照：TakePhotoActivity，以下为主要步骤：
1.实现TakePhoto.TakeResultListener,InvokeListener接口。
2.在onCreate,onActivityResult,onSaveInstanceState方法中调用TakePhoto对用的方法。
3.重写onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults)，添加如下代码。
@OverridepublicvoidonRequestPermissionsResult(intrequestCode,String[]permissions,int[]grantResults) {super.onRequestPermissionsResult(requestCode,permissions,grantResults);//以下代码为处理Android6.0、7.0动态权限所需TPermissionTypetype=PermissionManager.onRequestPermissionsResult(requestCode,permissions,grantResults);PermissionManager.handlePermissionsResult(this,type,invokeParam,this); }
4.重写TPermissionType invoke(InvokeParam invokeParam)方法，添加如下代码：
@OverridepublicTPermissionTypeinvoke(InvokeParaminvokeParam) {TPermissionTypetype=PermissionManager.checkPermission(TContextWrap.of(this),invokeParam.getMethod());if(TPermissionType.WAIT.equals(type)){this.invokeParam=invokeParam; }returntype; }
5.添加如下代码获取TakePhoto实例：
/** * 获取TakePhoto实例 * @return */publicTakePhotogetTakePhoto(){if (takePhoto==null){takePhoto= (TakePhoto)TakePhotoInvocationHandler.of(this).bind(newTakePhotoImpl(this,this)); }returntakePhoto; }
TakePhoto不仅支持对相关参数的自定义，也支持对UI的自定义，下面就像大家介绍如何自定义TakePhoto的相册与裁剪工具的UI。
如果TakePhoto自带相册的UI不符合你应用的主题的话，你可以对它进行自定义。方法如下：
在“res/layout”目录中创建一个名为“toolbar.xml”的布局文件，内容如下：
<?xml version="1.0" encoding="utf-8"?><android.support.v7.widget.Toolbarxmlns:android="http://schemas.android.com/apk/res/android"xmlns:app="http://schemas.android.com/apk/res-auto"android:layout_width="match_parent"android:layout_height="?attr/actionBarSize"app:theme="@style/CustomToolbarTheme"android:background="#ffa352"></android.support.v7.widget.Toolbar>
在“toolbar.xml”文件中你可以指定TakePhoto自带相册的主题以及Toolbar的背景色。
在“res/values”目录中创建一个名为“colors.xml”的资源文件，内容如下：
<?xml version="1.0" encoding="utf-8"?><resources> <colorname="multiple_image_select_primaryDark">#212121</color></resources>
通过上述方式便可以自定义状态栏的颜色。
在“res/values”目录的“string.xml”文件冲添加如下代码：
<resources> <stringname="album_view">选择图片</string> <stringname="image_view">单击选择</string> <stringname="add">确定</string> <stringname="selected">已选</string> <stringname="limit_exceeded">最多能选 %d 张</string></resources>
重写上述代码，便可以自定义TakePhoto自带相册的提示文字。
在“res/layout”目录中创建一个名为“crop__activity_crop.xml”与“crop__layout_done_cancel.xml”的布局文件，内容如下：
crop__activity_crop.xml
<?xml version="1.0" encoding="utf-8"?><RelativeLayoutxmlns:android="http://schemas.android.com/apk/res/android"android:layout_width="match_parent"android:layout_height="match_parent"> <com.soundcloud.android.crop.CropImageViewandroid:id="@+id/crop_image"android:layout_width="match_parent"android:layout_height="match_parent"android:layout_alignParentTop="true"android:background="@drawable/crop__texture"android:layout_above="@+id/done_cancel_bar" /> <includeandroid:id="@+id/done_cancel_bar"android:layout_alignParentBottom="true"layout="@layout/crop__layout_done_cancel"android:layout_height="50dp"android:layout_width="match_parent" /></RelativeLayout>
crop__layout_done_cancel.xml
<LinearLayoutxmlns:android="http://schemas.android.com/apk/res/android"style="@style/Crop.DoneCancelBar"> <FrameLayoutandroid:id="@+id/btn_cancel"style="@style/Crop.ActionButton"> <TextViewstyle="@style/Crop.ActionButtonText.Cancel" /> </FrameLayout> <FrameLayoutandroid:id="@+id/btn_done"style="@style/Crop.ActionButton"> <TextViewstyle="@style/Crop.ActionButtonText.Done" /> </FrameLayout></LinearLayout>
重写上述代码，便可以自定义TakePhoto裁切工具的UI。
TakePhoto提供拍照，从相册选择，从文件中选择三种方式获取图片。
/** * 从文件中获取图片（不裁剪） */voidonPickFromDocuments();/** * 从相册中获取图片（不裁剪） */voidonPickFromGallery();/** * 从相机获取图片(不裁剪) * @param outPutUri 图片保存的路径 */voidonPickFromCapture(UrioutPutUri);/** * 图片多选 * @param limit 最多选择图片张数的限制 **/voidonPickMultiple(intlimit);
以上三种方式均提供对应的裁剪API，详见：裁剪图片。
注：
由于不同Android Rom厂商对系统有不同程度的定制，有可能导致某种选择图片的方式不支持，所以为了提高TakePhoto的兼容性，当某种选的图片的方式不支持时，TakePhoto会自动切换成使用另一种选择图片的方式进行图片选择。
TakePhoto支持对图片进行裁剪，无论是拍照的照片,还是从相册、文件中选择的图片。你只需要调用TakePhoto的相应方法即可：
/** * 从相机获取图片并裁剪 * @param outPutUri 图片裁剪之后保存的路径 * @param options 裁剪配置 */voidonPickFromCaptureWithCrop(UrioutPutUri,CropOptionsoptions);/** * 从相册中获取图片并裁剪 * @param outPutUri 图片裁剪之后保存的路径 * @param options 裁剪配置 */voidonPickFromGalleryWithCrop(UrioutPutUri,CropOptionsoptions);/** * 从文件中获取图片并裁剪 * @param outPutUri 图片裁剪之后保存的路径 * @param options 裁剪配置 */voidonPickFromDocumentsWithCrop(UrioutPutUri,CropOptionsoptions);/** * 图片多选，并裁切 * @param limit 最多选择图片张数的限制 * @param options 裁剪配置 * */voidonPickMultipleWithCrop(intlimit,CropOptionsoptions);
另外，TakePhoto也支持你对指定图片进行裁剪：
/** * 裁剪图片 * @param imageUri 要裁剪的图片 * @param outPutUri 图片裁剪之后保存的路径 * @param options 裁剪配置 */voidonCrop(UriimageUri,UrioutPutUri,CropOptionsoptions)throwsTException;/** * 裁剪多张图片 * @param multipleCrop 要裁切的图片的路径以及输出路径 * @param options 裁剪配置 */voidonCrop(MultipleCropmultipleCrop,CropOptionsoptions)throwsTException;
CropOptions是用于裁剪的配置类，通过它你可以对图片的裁剪比例，最大输出大小，以及是否使用TakePhoto自带的裁剪工具进行裁剪等，进行个性化配置。
Usage:
CropOptionscropOptions=newCropOptions.Builder().setAspectX(1).setAspectY(1).setWithOwnCrop(true).create();getTakePhoto().onPickFromDocumentsWithCrop(imageUri,cropOptions);//或getTakePhoto().onCrop(imageUri,outPutUri,cropOptions);
注：
由于不同Android Rom厂商对系统有不同程度的定制，有可能系统中没有自带或第三方的裁剪工具，所以为了提高TakePhoto的兼容性，当系统中没有自带或第三方裁剪工具时，TakePhoto会自动切换到使用TakePhoto自带的裁剪工具进行裁剪。
另外TakePhoto4.0+支持指定使用TakePhoto自带相册,如：
takePhoto.setTakePhotoOptions(new TakePhotoOptions.Builder().setWithOwnGallery(true).create());详情可参考:Demo
你可以选择是否对图片进行压缩处理，你只需要告诉它你是否要启用压缩功能以及CompressConfig即可。
/** * 启用图片压缩 * @param config 压缩图片配置 * @param showCompressDialog 压缩时是否显示进度对话框 * @return */voidonEnableCompress(CompressConfigconfig,booleanshowCompressDialog);
Usage:
TakePhototakePhoto=getTakePhoto();takePhoto.onEnableCompress(compressConfig,true);takePhoto.onPickFromGallery();
如果你启用了图片压缩，TakePhoto会使用CompressImage对图片进行压缩处理，CompressImage目前支持对图片的尺寸以及图片的质量进行压缩。默认情况下，CompressImage开启了尺寸与质量双重压缩。
另外，你也可以对指定图片进行压缩：
Usage:
newCompressImageImpl(compressConfig,result.getImages(),newCompressImage.CompressListener() {@OverridepublicvoidonCompressSuccess(ArrayList<TImage>images) {//图片压缩成功 }@OverridepublicvoidonCompressFailed(ArrayList<TImage>images,Stringmsg) {//图片压缩失败 }}).compress();
CompressConfig是用于图片压缩的配置类，你可以通过CompressConfig.Builder对图片压缩后的尺寸以及质量进行相关设置。如果你想改变压缩的方式可以通过CompressConfig.Builder进行相关设置。
Usage:
CompressConfigcompressConfig=newCompressConfig.Builder().setMaxSize(50*1024).setMaxPixel(800).create();
CompressConfig config=new CompressConfig.Builder() .setMaxSize(maxSize) .setMaxPixel(width>=height? width:height) .create();takePhoto.onEnableCompress(config,showProgressBar);LubanOptions option=new LubanOptions.Builder() .setGear(Luban.CUSTOM_GEAR) .setMaxHeight(height) .setMaxWidth(width) .setMaxSize(maxSize) .create();CompressConfig config=CompressConfig.ofLuban(option);takePhoto.onEnableCompress(config,showProgressBar);详情可参考Demo:CustomHelper.java
由于Android6.0新增了"运行时权限控制(Runtime Permissions)"，为了应对这一改变，TakePhoto加入和自动权限管理，当TakePhoto检测到需要权限时，TakePhoto会自动申请权限，所以小伙伴们不用担心权限的使用问题。
在Android N中，Android 框架执行了 StrictMode，应用间共享文件和以前也有所区别。为了适配Android7.0的改变，同时也为了方便大家使用TakePhoto，TakePhoto会自动根据手机的Android版本自行适配，小伙伴们依旧可以向TakePhoto传递Uri imageUri = Uri.fromFile(file);类型的Uri而不用担心兼容性问题。
TakePhoto是基于Android官方标准API编写的，适配了目前市场上主流的Rom。如果你在使用过程中发现了适配问题，可以提交Issues。
- 为适配部分手机拍照时会回收
Activity，TakePhoto在onSaveInstanceState与onCreate做了相应的恢复处理。 - 为适配部分手机拍照或从相册选择图片时屏幕方向会发生转变,从而导致拍照失败的问题，可以在AndroidManifest.xml中对使用了
TakePhoto的Activity添加android:configChanges="orientation|keyboardHidden|screenSize"配置。
eg:
<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。
- Upgrade glide to 4.6.1；
- Upgrade buildToolsVersion & targetSdkVersion ；
- rename package name ;
Bugfixes
- Fixed bug and add new features(
62a6725)-@Yanqilong - fix 鲁班压缩出现路径重复(
a0a64a59)-@namezhouyu
- 压缩成功后返回原图路径(originalPath), 以便用户可以自行处理原图。
- 压缩成功后压缩路径path改为compressPath。
- 压缩成功后返回图片来源类型，现在分CAMERA, OTHER两种。
- 用户可以配置CompressConfig.enableReserveRaw(boolean)方法，ture保留原图，false删除原图，当且仅当类型为CAMERA此配置才有效
- 纠正拍照旋转角度功能改为可选
如果你的项目中启用了代码混淆，可在混淆规则文件(如：proguard-rules.pro)中添加如下代码：
-keep class com.jph.takephoto.** { *; }-dontwarn com.jph.takephoto.**-keep class com.darsh.multipleimageselect.** { *; }-dontwarn com.darsh.multipleimageselect.**-keep class com.soundcloud.android.crop.** { *; }-dontwarn com.soundcloud.android.crop.**About
一款用于在Android设备上获取照片（拍照或从相册、文件中选择）、裁剪图片、压缩图片的开源工具库