一、最終成果
本例是用android自帶的相冊獲取圖片的,並且處理了很多異常,最終你的activity只需要用很少的代碼就能獲得用戶選擇好的圖片了。
例子:
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> <uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS" />
加完權限后就可以編碼啦~
package com.example.jack.getphoto; import com.kale.lib.activity.KaleBaseActivity; import com.kale.lib.photo.GetSimplePhotoHelper; import com.kale.lib.photo.SimplePhoto; import android.os.Bundle; import android.util.Log; import android.view.View; import android.widget.Button; import android.widget.ImageView; /** * @author Jack Tony * <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> * <uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS" /> * @date 2015/4/26 */ public class MainActivity extends KaleBaseActivity implements View.OnClickListener { private ImageView photoImageView; private Button fromAlbumButton; private Button fromCameraButton; GetSimplePhotoHelper mPhotoHelper; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); mPhotoHelper = GetSimplePhotoHelper.getInstance(this); } protected void findViews() { photoImageView = getView(R.id.photo_imageView); fromAlbumButton = getView(R.id.fromAlbum_button); fromCameraButton = getView(R.id.fromCamera_button); photoImageView = getView(R.id.photo_imageView); } @Override protected void beforeSetViews() { } @Override protected void setViews() { fromAlbumButton.setOnClickListener(this); fromCameraButton.setOnClickListener(this); } @Override protected int getContentViewId() { return R.layout.activity_main; } @Override public void onClick(View v) { if (v == fromAlbumButton) { // Handle clicks for fromAlbumButton // 去選擇圖片,photo的路徑設置為null就好 mPhotoHelper.choicePhoto(GetSimplePhotoHelper.FROM_ALBUM, null,new MyListener()); } else if (v == fromCameraButton) { // Handle clicks for fromCameraButton mPhotoHelper.choicePhoto(GetSimplePhotoHelper.FROM_CAMERA, null,new MyListener()); // 可以設置拍照后圖片圖片保存的自定義路徑,如果不設置路徑,那么拍照后的照片不會保存在sd卡中 //mPhotoHelper.choicePhoto(GetSimplePhotoHelper.FROM_WAY.FROM_CAMERA, Environment.getExternalStorageDirectory()+ "/my_temp.jpg"); } } class MyListener implements GetSimplePhotoHelper.OnSelectedPhotoListener { @Override public void onSelectedPhoto(int fromWay, SimplePhoto photo) { if (photo != null) { photoImageView.setImageBitmap(photo.bitmap); Log.d(TAG, "uri = " + photo.uri.toString()); Log.d(TAG, "photo's degree = " + photo.degree); } } } }
很簡單吧,那么下面我們來看看如何實現這個功能。
二、GetSimplePhotoHelper
package com.kale.lib.photo; import com.kale.lib.utils.BitmapUtil; import android.app.Activity; import android.content.Intent; import android.graphics.Bitmap; import android.graphics.BitmapFactory; import android.net.Uri; import android.support.annotation.IntDef; import java.io.File; /** * @author Jack Tony * 從相冊或者從照相機得到一個圖片,沒有裁剪功能 * @date 2015/4/24 */ public class GetSimplePhotoHelper { public static final int FROM_ALBUM = 0; public static final int FROM_CAMERA = 1; @IntDef({GetSimplePhotoHelper.FROM_ALBUM, GetSimplePhotoHelper.FROM_CAMERA}) private @interface from { } private Activity mActivity; private String mPicFilePath; private int mFromWay; private GetSimplePhotoHelper(Activity activity) { mActivity = activity; } private static GetSimplePhotoHelper instance; public static GetSimplePhotoHelper getInstance(Activity activity) { if (instance == null) { instance = new GetSimplePhotoHelper(activity); } return instance; } /** * 從相冊或照相機獲得一張圖片 * * @param way 獲取圖片的途徑 * @param picFilePath 如果需要保存從相機拍攝的圖片,請指定保存圖片的全部路徑(通過相機拍照時才有效) * eg:GetPhotoHelper.choicePhoto(GetPhotoHelper.FROM_WAY.FROM_CAMERA, Environment.getExternalStorageDirectory()+ "/temp.jpg"); */ public void choicePhoto(@from final int way, String picFilePath, OnSelectedPhotoListener listener) { mFromWay = way; mPicFilePath = picFilePath; if (way == FROM_ALBUM) { choicePhotoFromAlbum(); } else if (way == FROM_CAMERA) { choicePhotoFromCamera(picFilePath); } mListener = listener; } /** * 啟動相冊的activity */ private void choicePhotoFromAlbum() { Intent intent = new Intent(mActivity, GetSimplePhotoActivity.class); intent.putExtra(GetSimplePhotoActivity.KEY_FROM_WAY, GetSimplePhotoActivity.VALUE_FROM_ALBUM); mActivity.startActivityForResult(intent, 0); } /** * 啟動相機的activity */ private void choicePhotoFromCamera(String picFilePath) { Intent intent = new Intent(mActivity, GetSimplePhotoActivity.class); intent.putExtra(GetSimplePhotoActivity.KEY_FROM_WAY, GetSimplePhotoActivity.VALUE_FROM_CAMERA); intent.putExtra(GetSimplePhotoActivity.KEY_PHOTO_PATH, picFilePath); mActivity.startActivityForResult(intent, 0); } /** * 得到已經選擇好的圖片,這個方法必須在onActivityResult中進行回調 * * @return 已經選擇好的bitmap */ protected void getSelectedPhoto(Uri uri) { //Logger.d("uri = " + uri); Bitmap bitmap = BitmapFactory.decodeFile(uri.toString()); // Logger.d("方向 =" + GetSimplePhotoUtil.getOrientation(uri)); if (bitmap != null) { bitmap = BitmapUtil.rotateBitmap(bitmap, GetSimplePhotoUtil.getPhotoDegreeByUri(uri)); } SimplePhoto photo = new SimplePhoto(); photo.bitmap = bitmap; photo.uri = uri; photo.degree = GetSimplePhotoUtil.getPhotoDegreeByUri(uri); // 如果來源是相機,而且沒有指定圖片保存的目錄,那么使用完畢后就立刻刪除相片 if (mFromWay == FROM_CAMERA && mPicFilePath == null) { File tempPicFile = new File(uri.toString()); if (tempPicFile != null) { tempPicFile.delete();//設置成功后清除之前的照片文件 } } mListener.onSelectedPhoto(mFromWay,photo); } private OnSelectedPhotoListener mListener; public interface OnSelectedPhotoListener { public void onSelectedPhoto(int way,SimplePhoto photo); } }
這個類主要是獲得activity並且獲得用戶期望獲取圖片的途徑,並且告訴GetSimplePhotoActivity(真正的處理類)。如果是想通過相機獲取圖片,那么這里還可以指定拍攝的照片保存的路徑,不設置就不保存照片。最后,它還處理了照片返回的結果,判斷照片的方向,進行正確的旋轉產生最終的bitmap。總之,這個類做的是獲得用戶獲取圖片的途徑,之后啟動activity來進行處理。在處理結束后,它進行結果的解析,最終返回一個SimplePhoto對象。
三、GetSimplePhotoActivity
GetSimplePhotoActivity是真正的處理類,用來啟動系統相冊或者是系統相機來獲取圖片。在啟動系統相冊的時候需要有個版本判斷,在高版本上獲得的uri可能會有點問題,所以這里需要判斷不同的版本,進行不同的處理。同時,它還應該對於獲得的圖片進行回調,返回一個uri。
package com.kale.lib.photo; import com.kale.lib.utils.IntentUtil; import android.app.Activity; import android.content.Intent; import android.net.Uri; import android.os.Bundle; import android.os.Environment; import java.io.File; /** * @author Jack Tony * @date 2015/4/24 */ public class GetSimplePhotoActivity extends Activity { private class RequestCode { public static final int ALBUM_OK = 1, ALBUM_OK_KITKAT = 2, CAMERA_OK = 3; } /** * 准備通過什么樣的方式來獲取圖片 */ public static final String KEY_FROM_WAY = "key_from_way"; /** * 圖片的全部路徑 */ public static final String KEY_PHOTO_PATH = "key_photo_path"; public static final int VALUE_FROM_ALBUM = 54345; public static final int VALUE_FROM_CAMERA = 46632; public static final String TEMP_PHOTO_FILE_NAME = "kale_temp_photo.jpg"; private File tempPicFile; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); if (!IntentUtil.isBundleEmpty(getIntent())) { Bundle bundle = getIntent().getExtras(); if (bundle.getInt(KEY_FROM_WAY, VALUE_FROM_ALBUM) == VALUE_FROM_ALBUM) { // 進行版本判斷 see:http://blog.csdn.net/tempersitu/article/details/20557383 if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.KITKAT) { GetSimplePhotoUtil.choicePicFromAlbum_kitkat(this, RequestCode.ALBUM_OK_KITKAT); } else { // 4.4以下 GetSimplePhotoUtil.choicePicFromAlbum(this, RequestCode.ALBUM_OK); } } else { if (bundle.getString(KEY_PHOTO_PATH) == null) { // 照相得到的圖片默認的保存路徑,用完后會自動刪除 tempPicFile = new File(Environment.getExternalStorageDirectory(), TEMP_PHOTO_FILE_NAME); } else { // 自定義照相得到的圖片的保存路徑,不會自動刪除 tempPicFile = new File(bundle.getString(KEY_PHOTO_PATH)); } tempPicFile.delete();// 清空之前的文件 GetSimplePhotoUtil.choicePicFromCamera(this, tempPicFile, RequestCode.CAMERA_OK); } } } @Override protected void onActivityResult(int requestCode, int resultCode, Intent data) { super.onActivityResult(requestCode, resultCode, data); Uri uri; switch (requestCode) { // 如果是直接從相冊獲取 case RequestCode.ALBUM_OK: //從相冊中獲取到圖片 if (data != null) { uri = data.getData(); finishAndReturnBitmap(uri); } else { finish(); } break; case RequestCode.ALBUM_OK_KITKAT: if (data != null) { uri = Uri.parse(GetSimplePhotoUtil.getPath(this, data.getData())); finishAndReturnBitmap(uri); } else { finish(); } break; // 如果是調用相機拍照時 case RequestCode.CAMERA_OK: // 當拍照到照片時操作 if (tempPicFile.exists()) { uri = Uri.parse(tempPicFile.getAbsolutePath()); finishAndReturnBitmap(uri); } else { finish(); } break; default: break; } } public void finishAndReturnBitmap(Uri uri) { GetSimplePhotoHelper.getInstance(this).getSelectedPhoto(uri); finish(); } }
四、工具類和模型類
GetSimplePhotoUtil
package com.kale.lib.photo; import android.annotation.SuppressLint; import android.app.Activity; import android.content.ContentUris; import android.content.Context; import android.content.Intent; import android.database.Cursor; import android.media.ExifInterface; import android.net.Uri; import android.os.Build; import android.os.Environment; import android.provider.DocumentsContract; import android.provider.MediaStore; import java.io.File; import java.io.IOException; /** * @author Jack Tony * @brief * @date 2015/4/25 */ class GetSimplePhotoUtil { /** * 從相冊獲取圖片 */ public static void choicePicFromAlbum(Activity activity, int requestCode) { // 來自相冊 Intent albumIntent = new Intent(Intent.ACTION_GET_CONTENT); albumIntent.addCategory(Intent.CATEGORY_OPENABLE); albumIntent.setType("image/*"); activity.startActivityForResult(albumIntent, requestCode); } /** * 4.4以上版本使用 * @see "http://blog.csdn.net/tempersitu/article/details/20557383" * * @param activity * @param requestCode */ public static void choicePicFromAlbum_kitkat(Activity activity, int requestCode) { // 來自相冊 Intent albumIntent = new Intent(Intent.ACTION_OPEN_DOCUMENT); albumIntent.addCategory(Intent.CATEGORY_OPENABLE); albumIntent.setType("image/*"); activity.startActivityForResult(albumIntent, requestCode); } /** * 拍照后獲取圖片 * * @param activity * @param cameraPhotoFile 照片的文件 * @param requestCode */ public static void choicePicFromCamera(Activity activity, File cameraPhotoFile,int requestCode) { // 來自相機 Intent cameraIntent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE); // 下面這句指定調用相機拍照后的照片存儲的路徑,這樣通過這個uri就可以得到這個照片了 cameraIntent.putExtra(MediaStore.EXTRA_OUTPUT, Uri.fromFile(cameraPhotoFile)); activity.startActivityForResult(cameraIntent, requestCode);// CAMERA_OK是用作判斷返回結果的標識 } private int aspectX = 1000; private int aspectY = 1000; private int outputX = 1; private int outputY = 1; private boolean shouldBeClip = false; private boolean shouldBeScale = false; /** * 設置比率,比如1:1 */ public void setAspectX(int aspectX, int aspectY) { this.aspectX = aspectX; this.aspectY = aspectY; } /** * 設置裁剪出來的圖片的寬高 */ public void setOutputX(int outputX, int outputY) { this.outputX = outputX; this.outputY = outputY; } /** * 裁剪時是否保留圖片的比例,如果是true那么就是保留 */ public void setShouldBeScale(boolean shoubeScale) { this.shouldBeScale = shoubeScale; } /** * 4.4得到的uri,需要以下方法來獲取文件的路徑 * * @param context * @param uri * @return */ @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]; } // TODO handle non-primary volumes } // 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 the remote address if (isGooglePhotosUri(uri)) return uri.getLastPathSegment(); 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 index = cursor.getColumnIndexOrThrow(column); return cursor.getString(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()); } /** * @param uri The Uri to check. * @return Whether the Uri authority is Google Photos. */ private static boolean isGooglePhotosUri(Uri uri) { return "com.google.android.apps.photos.content".equals(uri.getAuthority()); } /** * 得到圖片的方向 * * @param photoUri * @return */ public static int getOrientation(final Uri photoUri) { ExifInterface exifInterface = null; try { exifInterface = new ExifInterface(photoUri.toString()); } catch (IOException e) { e.printStackTrace(); } return exifInterface.getAttributeInt(ExifInterface.TAG_ORIENTATION, -1); } /** * 通過photo的uri來得到圖片的角度,從而判斷是否需要進行旋轉操作 * * @param uri * @return */ public static int getPhotoDegreeByUri(Uri uri) { int degree = 0; int orientation = GetSimplePhotoUtil.getOrientation(uri); if (orientation == ExifInterface.ORIENTATION_ROTATE_90) { degree = 90; } else if (orientation == ExifInterface.ORIENTATION_ROTATE_180) { degree = 180; } else if (orientation == ExifInterface.ORIENTATION_ROTATE_270) { degree = 270; } return degree; } }
SimplePhoto
package com.kale.lib.photo; import android.graphics.Bitmap; import android.net.Uri; /** * @author Jack Tony * @brief * @date 2015/4/26 */ public class SimplePhoto { /** * 圖片的uri,其實就是地址。eg:/storage/sdcard0/Tencent/QQ_Images/-1935240a504f548c.jpg */ public Uri uri; /** * 圖像需要旋轉的角度。方向不正確的圖像可以根據這個進行旋轉操作 */ public int degree; /** * 圖像的bitmap */ public Bitmap bitmap; }
五、配置文件
<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.kale.lib"> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> <uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS" /> <application android:name=".KaleApplication" android:allowBackup="true" android:label="@string/app_name"> <activity android:name=".photo.GetSimplePhotoActivity" android:theme="@android:style/Theme.Translucent" /> </application> </manifest>
最后你可以仿照最上面的例子進行編碼啦。
源碼下載:
http://download.csdn.net/detail/shark0017/8671823
新版的demo(推薦):http://download.csdn.net/detail/shark0017/8686807