在 Android 设备上获取照片、裁剪图片、压缩图片 @TakePhoto V3.0 发布
2016-09-26 17:25
441 查看
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有以下两种方式:
方式一:通过继承的方式1. 继承
TakePhotoActivity、
TakePhotoFragmentActivity、
TakePhotoFragment三者之一。
2. 通过
getTakePhoto()获取
TakePhoto实例进行相关操作。
3. 重写以下方法获取结果
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提供拍照,从相册选择,从文件中选择三种方式获取图片。API:
/** * 从文件中获取图片(不裁剪) */ 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自带的裁剪工具进行裁剪等,进行个性化配置。
Usage:
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即可。
API
/** * 启用图片压缩 * @param config 压缩图片配置 * @param showCompressDialog 压缩时是否显示进度对话框 * @return */ void onEnableCompress(CompressConfig config,boolean showCompressDialog);
Usage:
TakePhoto takePhoto=getTakePhoto(); takePhoto.onEnableCompress(compressConfig,true); takePhoto.onPickFromGallery();
如果你启用了图片压缩,
TakePhoto会使用
CompressImage对图片进行压缩处理,
CompressImage目前支持对图片的尺寸以及图片的质量进行压缩。默认情况下,
CompressImage开启了尺寸与质量双重压缩。
对指定图片进行压缩
另外,你也可以对指定图片进行压缩:Usage:
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进行相关设置。
Usage:
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”配置。
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。最后
既然来了,留下个喜欢再走吧,鼓励我继续创作(^_^)∠※如果喜欢我的文章,那就关注我的博客吧,让我们一起做朋友~~
戳这里,加关注哦:
微博:第一时间获取推送个人博客:干货文章都在这里哦
GitHub:我的开源项目
相关文章推荐
- TakePhoto是一款用于在Android设备上获取照片(拍照或从相册、文件中选择)、裁剪图片、压缩图片的开源工具库,目前最新版本3.0.0。
- Android设备上获取照片、裁剪图片、压缩图片
- 一款用于在Android设备上获取照片(拍照或从相册、文件中选择)、裁剪图片、压缩图片的开源工具库
- Android获取照片、裁剪图片、压缩图片
- android 图片压缩,自动旋转保存,查看照片信息,拍照设备类型等
- Android 图片压缩、照片选择、裁剪,上传、一整套图片解决方案
- Android ImageUtils 图片工具类,包括:小米从相册调图像空指针,三星旋转照片,压缩图片,保存Bitmap到本地,获取本地视频的缩略图,毛化玻璃效果,代码以后会更新
- Android 图片压缩、照片选择、裁剪,上传、一整套图片解决方案
- Android获取图片、裁剪、压缩、上传头像
- Android 4.4从图库选择图片,获取图片路径并裁剪
- mono for android 获取手机照片或拍照并裁剪保存
- Android 拍照/相册 获取图片裁剪显示
- Android 4.4从图库选择图片,获取图片路径并裁剪
- Android 4.4从图库选择图片,获取图片路径并裁剪
- Android之获取本地图片并压缩方法
- Android 4.4从图库选择图片,获取图片路径并裁剪
- Android之获取本地图片并压缩方法
- Android 4.4从图库选择图片,获取图片路径并裁剪
- android 图片获取裁剪上传
- Android之获取本地图片并压缩方法