一、 UTakePhoto简介
- 支持系统拍照，及自定义Intent拍照
- 支持相册选取，及自定义Intent获取
- 支持图片压缩，默认采用鲁班压缩
- 支持图片裁剪，系统裁剪及自带裁剪
- 自动适配camera及sd权限
- 适配AndroidQ
- 链式调用
gitHub地址：https://github.com/songlongGithub/uTakePhoto
二、 使用
1、依赖：
implementation 'io.github.songlonggithub:uTakePhoto:1.2.0'
2、 初始化
UTakePhoto.init()；可以在application中配置压缩和裁剪
public static void init(CompressConfig compressConfig, CropOptions cropOptions) {
mCompressConfig = compressConfig;
mCropOptions = cropOptions;
}
3、 快速使用：
UTakePhoto.with(mActivity).openCamera().build(new ITakePhotoResult() {
@Override
public void takeSuccess(List<Uri> uriList) {
}
@Override
public void takeFailure(TakeException ex) {
}
@Override
public void takeCancel() {
}
});
或
UTakePhoto.with(mFragment)
.openAlbum()
.setCrop(new CropOptions.Builder().create())
.setCompressConfig(new CompressConfig.Builder().create())
.build(new ITakePhotoResult() {
@Override
public void takeSuccess(List<Uri> uriList) {
}
@Override
public void takeFailure(TakeException ex) {
}
@Override
public void takeCancel() {
}
});
4、 基本用法：
图片默认储存在context.getExternalFilesDir("Pictures") 目录下，不需要指定的话，一行代码足矣：
UTakePhoto.with(mActivity).openCamera().build(new ITakePhotoResult() {
@Override
public void takeSuccess(List<Uri> uriList) {
}
@Override
public void takeFailure(TakeException ex) {
}
@Override
public void takeCancel() {
}
});
5、拍照
/**
* 默认储存在getExternalFilesDir(Pictures)目录下
*
* @return
*/
public TakePhotoManager openCamera() {
return openCamera(null, null, null);
}
/**
* 打开系统相机，输出路径自定义
*
* @param outPutUri 拍照路径
* @return
*/
public TakePhotoManager openCamera(Uri outPutUri) {
return openCamera(outPutUri, null, null);
}
/**
* 打开系统相机，输出路径自定义
* 在androidQ上建议采用这个方法，因为如果采用传入mediaStore的Uri的方式，会在相册里创建一个空的img
*
* @param relativePath androidQ上清单文件中android:requestLegacyExternalStorage="true"
* 则relativePath 必须以 Pictures/DCIM 为跟路径；
* Q以下默认根路径是Environment.getExternalStorageDirectory()
* @return
*/
public TakePhotoManager openCamera(String relativePath) {
return openCamera(null, relativePath, null);
}
如果想获取拍照图片的话，传入指定Uri或者使用relativePath两种方式。 relativePath对应androidQ中MediaStore.Images.Media.RELATIVE_PATH， androidQ以下的以Environment.getExternalStorageDirectory()为根路径。根据需要选择
6、选择照片
默认打开相册Intent
/**
* 打开相册
*
* @return
*/
public TakePhotoManager openAlbum() {
return openAlbum(null);
}
/**
* 打开指定相册
*
* @param intent 通过Intent跳转的时候，需要返回setResult(RESULT_OK,Intent.setData(Uri)))
* @return this
*/
public TakePhotoManager openAlbum(Intent intent) {
takeType = TYPE_SELECT_IMAGE;
this.intent = intent;
return this;
}
7、裁剪
CropOptions cropOptions = new CropOptions.Builder()
.setAspectX(1).setAspectY(1)
.setOutputX(100).setOutputY(1)
.setWithOwnCrop(true)//使用系统裁剪还是自带裁剪
.create();
UTakePhoto.with(mActivity).openCamera().setCrop(cropOptions)
8、压缩
压缩采用luban压缩，计算inSampleSize，简单压缩，如果不想使用，可以自己拿到图片处理
CompressConfig compressConfig = new CompressConfig.Builder()
.setFocusAlpha(false)//是否支持透明度
.setLeastCompressSize(200)//最小压缩尺寸
.setTargetUri()//压缩图片储存路径
.create();
UTakePhoto.with(mActivity).openCamera().setCompressConfig(compressConfig)
9、旋转原图
在不进行压缩和裁剪的情况下，是否对图片进行旋转操作，旋转操作是耗时操作
/**
* 在返回原图的时候，也就是不进行压缩和裁剪的处理直接返回原图的时候，是否需要旋转图片
* 压缩和裁剪会自动处理旋转角度
*
* @param rotate true：旋转 false：原图
* @return
*/
public TakePhotoManager setCameraPhotoRotate(boolean rotate) {
this.rotateCameraPhoto = rotate;
return this;
}
10、注意
1.如何获取path
因为为了兼容Android Q，放弃了传统的以File输入输出，如果仍然想获取File文件， 一种是指定scheme为File的Uri，但在AndroidQ上可能无法使用； 另一种就是不传Uri，这时候返回的就是路径为getExternalFilesDir(Pictures)目录下，scheme为File的Uri，可以通过uri.getPath（）获取File； 压缩返回同理
2.relativePath如何使用
relativePath对应AndoridQ的MediaStore.Images.Media.RELATIVE_PATH，MediaColumns.RELATIVE_PATH来指定存储的次级目录，这个目录可以使多级； 但使用的时候需要注意，必须以 Pictures/DCIM 为跟路径；AndroidQ以下根路径Environment.getExternalStorageDirectory()，这时候relativePath就可以为任意子路径； 建议使用relativePath的时候，加以区分，如openCamera(Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q ? "Pictures/项目名称等等" : "项目名称等等")； 使用relativePath会主动刷新相册。
3.建议采用压缩
目前手机拍照动不动就2Mb，3Mb，甚至更大，建议默认采用压缩，基于luban压缩算法，效果还是很好的。
4.支持多图选择吗
支持，正在写，还没写完，哈哈
5.支持AndroidX吗
支持，低版本的有需求的话，我再写一个；
6.AndroidQ的问题 MediaStore中，
DATA（即_data）字段，在Android Q中开始废弃，不再表示文件的真实路径。读写文件或判断文件是否存在，不应该使用DATA字段，而要使用openFileDescriptor。 同时也无法直接使用路径访问公共目录的文件。 androidQ的储存空间适配，请参考https://github.com/songlongGithub/scoped_storage_sample
5.有问题可以通过issue反馈，或者发送到616727136@qq.com邮箱
11、相册获取的图片，上传亚马逊报错：
已经给了动态权限还是报如下错误：
Unable to calculate MD5 hash: /storage/emulated/0/Pictures/DCIM/20231026104618_CROP.jpg: open failed: EACCES (Permission denied)
解决办法是在manifest的applicaiton标签添加 ：
android:requestLegacyExternalStorage="true"
详细原理请看：https://www.jianshu.com/p/e576bfcf80ad
12、uri转化为file
//调用
val file: File = MyOpenCameraAlbum.uriToFile(uriList[0], this)
方法：
package com.kana.crazytv.app.util;
import android.content.ContentResolver;
import android.content.Context;
import android.database.Cursor;
import android.net.Uri;
import android.provider.MediaStore;
import java.io.File;
public class MyOpenCameraAlbum {
public static File uriToFile(Uri uri, Context context) {
String path = null;
if ("file".equals(uri.getScheme())) {
path = uri.getEncodedPath();
if (path != null) {
path = Uri.decode(path);
ContentResolver cr = context.getContentResolver();
StringBuffer buff = new StringBuffer();
buff.append("(").append(MediaStore.Images.ImageColumns.DATA).append("=").append("'" + path + "'").append(")");
Cursor cur = cr.query(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, new String[]{MediaStore.Images.ImageColumns._ID, MediaStore.Images.ImageColumns.DATA}, buff.toString(), null, null);
int index = 0;
int dataIdx = 0;
for (cur.moveToFirst(); !cur.isAfterLast(); cur.moveToNext()) {
index = cur.getColumnIndex(MediaStore.Images.ImageColumns._ID);
index = cur.getInt(index);
dataIdx = cur.getColumnIndex(MediaStore.Images.ImageColumns.DATA);
path = cur.getString(dataIdx);
}
cur.close();
if (index == 0) {
} else {
Uri u = Uri.parse("content://media/external/images/media/" + index);
System.out.println("temp uri is :" + u);
}
}
if (path != null) {
return new File(path);
}
} else if ("content".equals(uri.getScheme())) {
// 4.2.2以后
String[] proj = {MediaStore.Images.Media.DATA};
Cursor cursor = context.getContentResolver().query(uri, proj, null, null, null);
if (cursor.moveToFirst()) {
int columnIndex = cursor.getColumnIndexOrThrow(MediaStore.Images.Media.DATA);
path = cursor.getString(columnIndex);
}
cursor.close();
return new File(path);
} else {
}
return null;
}
}
网友评论