在线时间:8:00-16:00
迪恩网络APP
随时随地掌握行业动态
扫描二维码
关注迪恩网络微信公众号
开源软件名称:TakePhoto开源软件地址:https://gitee.com/JHFreedm/TakePhoto开源软件介绍:TakePhoto 简介
V4.0
GitHub地址: https://github.com/crazycodeboy/TakePhoto 目录安装说明Gradle: compile 'com.jph.takephoto:takephoto_library:4.0.3' Maven: <dependency> <groupId>com.jph.takephoto</groupId> <artifactId>takephoto_library</artifactId> <version>4.0.3</version> <type>pom</type></dependency> 演示运行效果图: 使用说明使用TakePhoto有以下两种方式:方式一:通过继承的方式
void takeSuccess(TResult result); void takeFail(TResult result,String msg); void takeCancel(); 此方式使用简单,满足的大部分的使用需求,具体使用详见simple。如果通过继承的方式无法满足实际项目的使用,可以通过下面介绍的方式。 方式二:通过组装的方式 可参照:TakePhotoActivity,以下为主要步骤: 1.实现 2.在 3.重写 @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.重写 @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; } 自定义UITakePhoto不仅支持对相关参数的自定义,也支持对UI的自定义,下面就像大家介绍如何自定义TakePhoto的相册与裁剪工具的UI。 自定义相册如果TakePhoto自带相册的UI不符合你应用的主题的话,你可以对它进行自定义。方法如下: 自定义Toolbar在“res/layout”目录中创建一个名为“toolbar.xml”的布局文件,内容如下: <?xml version="1.0" encoding="utf-8"?><android.support.v7.widget.Toolbar xmlns: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> <color name="multiple_image_select_primaryDark">#212121</color></resources> 通过上述方式便可以自定义状态栏的颜色。 自定义提示文字在“res/values”目录的“string.xml”文件冲添加如下代码: <resources> <string name="album_view">选择图片</string> <string name="image_view">单击选择</string> <string name="add">确定</string> <string name="selected">已选</string> <string name="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"?><RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" android:layout_width="match_parent" android:layout_height="match_parent"> <com.soundcloud.android.crop.CropImageView android: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" /> <include android: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 <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" style="@style/Crop.DoneCancelBar"> <FrameLayout android:id="@+id/btn_cancel" style="@style/Crop.ActionButton"> <TextView style="@style/Crop.ActionButtonText.Cancel" /> </FrameLayout> <FrameLayout android:id="@+id/btn_done" style="@style/Crop.ActionButton"> <TextView style="@style/Crop.ActionButtonText.Done" /> </FrameLayout></LinearLayout> 重写上述代码,便可以自定义TakePhoto裁切工具的UI。 API获取图片TakePhoto提供拍照,从相册选择,从文件中选择三种方式获取图片。 API:/** * 从文件中获取图片(不裁剪) */void onPickFromDocuments();/** * 从相册中获取图片(不裁剪) */void onPickFromGallery();/** * 从相机获取图片(不裁剪) * @param outPutUri 图片保存的路径 */void onPickFromCapture(Uri outPutUri);/** * 图片多选 * @param limit 最多选择图片张数的限制 **/void onPickMultiple(int limit); 以上三种方式均提供对应的裁剪API,详见:裁剪图片。 裁剪图片API
/** * 从相机获取图片并裁剪 * @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
Usage: CropOptions cropOptions=new CropOptions.Builder().setAspectX(1).setAspectY(1).setWithOwnCrop(true).create(); getTakePhoto().onPickFromDocumentsWithCrop(imageUri,cropOptions); //或 getTakePhoto().onCrop(imageUri,outPutUri,cropOptions); 注:
压缩图片你可以选择是否对图片进行压缩处理,你只需要告诉它你是否要启用压缩功能以及 API /** * 启用图片压缩 * @param config 压缩图片配置 * @param showCompressDialog 压缩时是否显示进度对话框 * @return */ void onEnableCompress(CompressConfig config,boolean showCompressDialog); Usage: TakePhoto takePhoto=getTakePhoto();takePhoto.onEnableCompress(compressConfig,true);takePhoto.onPickFromGallery(); 如果你启用了图片压缩, 对指定图片进行压缩另外,你也可以对指定图片进行压缩: 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=new CompressConfig.Builder().setMaxSize(50*1024).setMaxPixel(800).create(); 指定压缩工具使用TakePhoto压缩工具进行压缩:CompressConfig config=new CompressConfig.Builder() .setMaxSize(maxSize) .setMaxPixel(width>=height? width:height) .create();takePhoto.onEnableCompress(config,showProgressBar); 使用Luban进行压缩: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);
兼容性Android6.0由于Android6.0新增了"运行时权限控制(Runtime Permissions)",为了应对这一改变,TakePhoto加入和自动权限管理,当TakePhoto检测到需要权限时,TakePhoto会自动申请权限,所以小伙伴们不用担心权限的使用问题。 Android7.0在Android N中,Android 框架执行了 StrictMode,应用间共享文件和以前也有所区别。为了适配Android7.0的改变,同时也为了方便大家使用TakePhoto,TakePhoto会自动根据手机的Android版本自行适配,小伙伴们依旧可以向TakePhoto传递 TakePhoto在深度兼容性方面的测试获取更高的兼容性
<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。 更新说明v4.0.3(2017/1/18)Bugfixes
v4.0.2(2016/11/28)
最后关于代码混淆如果你的项目中启用了代码混淆,可在混淆规则文件(如: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.** |
请发表评论