原文链接:http://www.apkbus.com/blog-705730-61863.html
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:
[代码]xml代码:
1 |
|
Maven:
[代码]xml代码:
1 2 3 4 5 6 |
|
使用说明
使用TakePhoto有以下两种方式:
方式一:通过继承的方式
1. 继承TakePhotoActivity
、TakePhotoFragmentActivity
、TakePhotoFragment
三者之一。
2. 通过getTakePhoto()
获取TakePhoto
实例进行相关操作。
3. 重写以下方法获取结果
[代码]java代码:
1 2 3 |
|
此方式使用简单,满足的大部分的使用需求,具体使用详见simple。如果通过继承的方式无法满足实际项目的使用,可以通过下面介绍的方式。
方式二:通过组装的方式
可参照:TakePhotoActivity,以下为主要步骤:
1.实现TakePhoto.TakeResultListener,InvokeListener
接口。
2.在 onCreate
,onActivityResult
,onSaveInstanceState
方法中调用TakePhoto对用的方法。
3.重写onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults)
,添加如下代码。
[代码]java代码:
1 2 3 4 5 6 7 |
|
4.重写TPermissionType invoke(InvokeParam invokeParam)
方法,添加如下代码:
[代码]java代码:
1 2 3 4 5 6 7 8 |
|
5.添加如下代码获取TakePhoto实例:
[代码]java代码:
01 02 03 04 05 06 07 08 09 10 |
|
API
获取图片
TakePhoto提供拍照,从相册选择,从文件中选择三种方式获取图片。
API:
[代码]java代码:
01 02 03 04 05 06 07 08 09 10 11 12 13 14 15 16 17 18 |
|
以上三种方式均提供对应的裁剪API,详见:裁剪图片。
注:
由于不同Android Rom厂商对系统有不同程度的定制,有可能导致某种选择图片的方式不支持,所以为了提高TakePhoto
的兼容性,当某种选的图片的方式不支持时,TakePhoto
会自动切换成使用另一种选择图片的方式进行图片选择。
裁剪图片
API
TakePhoto
支持对图片进行裁剪,无论是拍照的照片,还是从相册、文件中选择的图片。你只需要调用TakePhoto
的相应方法即可:
[代码]java代码:
01 02 03 04 05 06 07 08 09 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 |
|
#### 对指定图片进行裁剪
另外,TakePhoto也支持你对指定图片进行裁剪:
[代码]java代码:
01 02 03 04 05 06 07 08 09 10 11 12 13 |
|
CropOptions
CropOptions
是用于裁剪的配置类,通过它你可以对图片的裁剪比例,最大输出大小,以及是否使用TakePhoto
自带的裁剪工具进行裁剪等,进行个性化配置。
Usage:
[代码]java代码:
1 2 3 4 |
|
注:
由于不同Android Rom厂商对系统有不同程度的定制,有可能系统中没有自带或第三方的裁剪工具,所以为了提高TakePhoto
的兼容性,当系统中没有自带或第三方裁剪工具时,TakePhoto
会自动切换到使用TakePhoto
自带的裁剪工具进行裁剪。
压缩图片
你可以选择是否对图片进行压缩处理,你只需要告诉它你是否要启用压缩功能以及CompressConfig
即可。
API
[代码]java代码:
1 2 3 4 5 6 7 |
|
Usage:
[代码]java代码:
1 2 3 |
|
如果你启用了图片压缩,TakePhoto
会使用CompressImage
对图片进行压缩处理,CompressImage
目前支持对图片的尺寸以及图片的质量进行压缩。默认情况下,CompressImage
开启了尺寸与质量双重压缩。
对指定图片进行压缩
另外,你也可以对指定图片进行压缩:
Usage:
[代码]java代码:
01 02 03 04 05 06 07 08 09 10 |
|
CompressConfig
CompressConfig
是用于图片压缩的配置类,你可以通过CompressConfig.Builder
对图片压缩后的尺寸以及质量进行相关设置。如果你想改变压缩的方式可以通过CompressConfig.Builder
进行相关设置。
Usage:
[代码]java代码:
1 |
|
兼容性
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在深度兼容性方面的测试获取更高的兼容性
TakePhot
o是基于Android官方标准API编写的,适配了目前市场上主流的Rom。如果你在使用过程中发现了适配问题,可以提交Issues。
1. 为适配部分手机拍照时会回收Activity
,TakePhoto
在onSaveInstanceState
与 onCreate
做了相应的恢复处理。
2. 为适配部分手机拍照或从相册选择图片时屏幕方向会发生转变,从而导致拍照失败的问题,可以在AndroidManifest.xml中对使用了TakePhoto
的Activity
添加android:configChanges=”orientation|keyboardHidden|screenSize”配置。
eg:
[代码]xml代码:
01 02 03 04 05 06 07 08 09 10 |
|
贡献
如果你在使用TakePhoto中遇到任何问题可以提Issues出来。另外欢迎大家为TakePhoto贡献智慧,欢迎大家Fork and Pull requests。
共同学习,写下你的评论
评论加载中...
作者其他优质文章