从相机（相册）获取图片并剪裁的最佳实践
在开发一些APP的过程中，我们可能涉及到头像的处理，比如从手机或者相册获取头像，剪裁成自己需要的头像，设置或上传头像等。网上一些相关的资料也是多不胜数，但在实际应用中往往会存在各种问题，没有一个完美的解决方案。由于近期项目的需求，就研究了一下，目前看来还没有什么问题。
这里我们只讨论获取、剪裁与设置，上传流程根据自己的业务需求添加。先上一张流程图：
这图是用Google Drive的绘图工具绘制的，不得不赞叹Google可以把在线编辑工具做得如此强大。好吧，我就是Google的脑残粉！回到主题，这是我设计的思路，接下来进行详细分析：
1、获得图片的途径无非就两种，第一是相机拍摄，第二是从本地相册获取。
2、我在SD卡上创建了一个文件夹，里面有两个Uri，一个是用于保存拍照时获得的原始图片，一个是保存剪裁后的图片。之前我考虑过用同一个Uri来保存图片，但是在实践中遇到一个问题，当拍照后不进行剪裁，那么下次从SD卡拿到就是拍照保存的大图，不仅丢失了之前剪裁的图片，还会因为加载大图导致内存崩溃。基于此考虑，我选择了两个Uri来分别保存图片。
3、相机拍摄时，我们使用Intent调用系统相机，并将设置输出设置到SDCard\xx\photo_file.jpg，以下是代码片段：
//调用系统相机 Intent intentCamera = new Intent(MediaStore.ACTION_IMAGE_CAPTURE); //将拍照结果保存至photo_file的Uri中，不保留在相册中 intentCamera.putExtra(MediaStore.EXTRA_OUTPUT, imagePhotoUri); startActivityForResult(intentCamera, PHOTO_REQUEST_CAREMA);
在回调时，我们需要对photo_file.jpg调用系统工具进行剪裁，并设置输出设置到SDCard\xx\crop_file.jpg，以下是代码片段：
case PHOTO_REQUEST_CAREMA: if (resultCode == RESULT_OK) { //从相机拍摄保存的Uri中取出图片，调用系统剪裁工具 if (imagePhotoUri != null) { CropUtils.cropImageUri(this, imagePhotoUri, imageUri, ibUserIcon.getWidth(), ibUserIcon.getHeight(), PHOTO_REQUEST_CUT); } else { ToastUtils.show(this, "没有得到拍照图片"); } } else if (resultCode == RESULT_CANCELED) { ToastUtils.show(this, "取消拍照"); } else { ToastUtils.show(this, "拍照失败"); } break;
//调用系统的剪裁处理图片并保存至imageUri中
public static void cropImageUri(Activity activity, Uri orgUri, Uri desUri, int width, int height, int requestCode) { Intent intent = new Intent("com.android.camera.action.CROP"); intent.setDataAndType(orgUri, "image/*"); intent.putExtra("crop", "true");
intent.putExtra("aspectX", 1); intent.putExtra("aspectY", 1); intent.putExtra("outputX", width); intent.putExtra("outputY", height); intent.putExtra("scale", true); //将剪切的图片保存到目标Uri中 intent.putExtra(MediaStore.EXTRA_OUTPUT, desUri); intent.putExtra("return-data", false); intent.putExtra("outputFormat", Bitmap.CompressFormat.JPEG.toString()); intent.putExtra("noFaceDetection", true); activity.startActivityForResult(intent, requestCode);
}
最后，我们需要在回调中取出crop_file.jpg，因为剪裁时，对图片已经进行了压缩，所以也不用担心内存的问题，在这里我提供两个方法，第一个是直接获取原始图片的Bitmap，第二个是获取原始图片并做成圆形，相信大多数的人对后者比较感兴趣，哈哈！以下是代码片段：
case PHOTO_REQUEST_CUT: if (resultCode == RESULT_OK) { Bitmap bitmap = decodeUriiAsBimap(this,imageCropUri) } else if (resultCode == RESULT_CANCELED) { ToastUtils.show(this, "取消剪切图片"); } else { ToastUtils.show(this, "剪切失败"); } break;
//从Uri中获取Bitmap格式的图片 private static Bitmap decodeUriAsBitmap(Context context, Uri uri) { Bitmap bitmap; try { bitmap = BitmapFactory.decodeStream(context.getContentResolver().openInputStream(uri)); } catch (FileNotFoundException e) { e.printStackTrace(); return null; } return bitmap; }
//获取圆形图片 public static Bitmap getRoundedCornerBitmap(Bitmap bitmap) { if (bitmap == null) { return null; } Bitmap output = Bitmap.createBitmap(bitmap.getWidth(), bitmap.getHeight(), Bitmap.Config.ARGB_8888); Canvas canvas = new Canvas(output); final Paint paint = new Paint(); /* 去锯齿 */ paint.setAntiAlias(true); paint.setFilterBitmap(true); paint.setDither(true); // 保证是方形，并且从中心画 int width = bitmap.getWidth(); int height = bitmap.getHeight(); int w; int deltaX = 0; int deltaY = 0; if (width <= height) { w = width; deltaY = height - w; } else { w = height; deltaX = width - w; } final Rect rect = new Rect(deltaX, deltaY, w, w); final RectF rectF = new RectF(rect); paint.setAntiAlias(true); canvas.drawARGB(0, 0, 0, 0); // 圆形，所有只用一个 int radius = (int) (Math.sqrt(w * w * 2.0d) / 2); canvas.drawRoundRect(rectF, radius, radius, paint); paint.setXfermode(new PorterDuffXfermode(PorterDuff.Mode.SRC_IN)); canvas.drawBitmap(bitmap, rect, rect, paint); return output; }
4、相册获取时，这也是最难的地方。Android 4.4以下的版本，从相册获取的图片Uri能够完美调用系统剪裁工具，或者直接从选取相册是带入剪裁图片的Intent，而且效果非常完美。但是在Android 4.4及其以上的版本，获取到的Uri根本无法调用系统剪裁工具，会直接导致程序崩溃。我也是研究了很久，才发现两者的Uri有很大的区别，Google官方文档中让开发者使用Intent.ACTION_GET_CONTENT代替以前的Action，并且就算你仍然使用以前的Action，都会返回一种新型的Uri，我个人猜测是因为Google把所有的内容获取分享做成一个统一的Uri，如有不对，请指正！想通这一点后，问题就变得简单了，我把这种新型的Uri重新封装一次，得到以为"file:\\..."标准的绝对路劲，传入系统剪裁工具中，果然成功了，只是这个封装过程及其艰难，查阅了很多资料，终于还是拿到了。下面说下具体步骤：
第一、调用系统相册，以下是代码片段：
//调用系统相册 Intent photoPickerIntent = new Intent(Intent.ACTION_GET_CONTENT); photoPickerIntent.setType("image/*"); startActivityForResult(photoPickerIntent, PHOTO_REQUEST_GALLERY);
第二、在回调中，重新封装Uri，并调用系统剪裁工具将输出设置到crop_file.jpg，调用系统剪裁工具代码在拍照获取的步骤中已经贴出，这里就不重复制造车轮了，重点贴重新封装Uri的代码，以下是代码片段：
case PHOTO_REQUEST_GALLERY: if (resultCode == RESULT_OK) { //从相册选取成功后，需要从Uri中拿出图片的绝对路径，再调用剪切 Uri newUri = Uri.parse("file:///" + CropUtils.getPath(this, data.getData())); if (newUri != null) { CropUtils.cropImageUri(this, newUri, imageUri, ibUserIcon.getWidth(), ibUserIcon.getHeight(), PHOTO_REQUEST_CUT); } else { ToastUtils.show(this, "没有得到相册图片"); } } else if (resultCode == RESULT_CANCELED) { ToastUtils.show(this, "从相册选取取消"); } else { ToastUtils.show(this, "从相册选取失败"); } break;
@SuppressLint("NewApi")
public static String getPath(final Context context, final Uri uri) {
final boolean isKitKat = Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT;
// DocumentProvider
if (isKitKat && DocumentsContract.isDocumentUri(context, uri)) {
// ExternalStorageProvider
if (isExternalStorageDocument(uri)) {
final String docId = DocumentsContract.getDocumentId(uri);
final String[] split = docId.split(":");
final String type = split[0];
if ("primary".equalsIgnoreCase(type)) {
return Environment.getExternalStorageDirectory() + "/"+ split[1];
}
}
// DownloadsProvider
else if (isDownloadsDocument(uri)) {
final String id = DocumentsContract.getDocumentId(uri);
final Uri contentUri = ContentUris.withAppendedId(Uri.parse("content://downloads/public_downloads"),Long.valueOf(id));
return getDataColumn(context, contentUri, null, null);
}
// MediaProvider
else if (isMediaDocument(uri)) {
final String docId = DocumentsContract.getDocumentId(uri);
final String[] split = docId.split(":");
final String type = split[0];
Uri contentUri = null;
if ("image".equals(type)) {
contentUri = MediaStore.Images.Media.EXTERNAL_CONTENT_URI;
} else if ("video".equals(type)) {
contentUri = MediaStore.Video.Media.EXTERNAL_CONTENT_URI;
} else if ("audio".equals(type)) {
contentUri = MediaStore.Audio.Media.EXTERNAL_CONTENT_URI;
}
final String selection = "_id=?";
final String[] selectionArgs = new String[]{split[1]};
return getDataColumn(context, contentUri, selection,selectionArgs);
}
}
// MediaStore (and general)
else if ("content".equalsIgnoreCase(uri.getScheme())) {
return getDataColumn(context, uri, null, null);
}
// File
else if ("file".equalsIgnoreCase(uri.getScheme())) {
return uri.getPath();
}
return null;
}
/**
* Get the value of the data column for this Uri. This is useful for
* MediaStore Uris, and other file-based ContentProviders.
*
* @param context The context.
* @param uri The Uri to query.
* @param selection (Optional) Filter used in the query.
* @param selectionArgs (Optional) Selection arguments used in the query.
* @return The value of the _data column, which is typically a file path.
*/
private static String getDataColumn(Context context, Uri uri,String selection, String[] selectionArgs) {
Cursor cursor = null;
final String column = "_data";
final String[] projection = {column};
try {
cursor = context.getContentResolver().query(uri, projection,selection, selectionArgs, null);
if (cursor != null && cursor.moveToFirst()) {
final int column_index = cursor.getColumnIndexOrThrow(column);
return cursor.getString(column_index);
}
} finally {
if (cursor != null)
cursor.close();
}
return null;
}
/**
* @param uri The Uri to check.
* @return Whether the Uri authority is ExternalStorageProvider.
*/
private static boolean isExternalStorageDocument(Uri uri) {
return "com.android.externalstorage.documents".equals(uri.getAuthority());
}
/**
* @param uri The Uri to check.
* @return Whether the Uri authority is DownloadsProvider.
*/
private static boolean isDownloadsDocument(Uri uri) {
return "com.android.providers.downloads.documents".equals(uri.getAuthority());
}
/**
* @param uri The Uri to check.
* @return Whether the Uri authority is MediaProvider.
*/
private static boolean isMediaDocument(Uri uri) {
return "com.android.providers.media.documents".equals(uri.getAuthority());
}
后续的系统剪裁工具调用跟拍照获取步骤一致，请参见上的代码。
5、所有步骤完成，在Nexus 5设备中的最新系统中测试通过，在小米、三星等一些设备中表现也很完美。如果在你的设备上存在缺陷，一定要跟帖给我反馈，谢谢！
记录于此，希望能帮助到一些正遇到这种问题的朋友！
