概述
最近在看 nanChen 寫的圖片選擇器 ImagePicker,感覺寫得很不錯,也打算把從中學到的東西寫下來。很多時候,遇到一個好的框架能夠降低開發成本這是好事。但是也要去了解其內部具體實現邏輯,說不定哪天你需要完成一個類似的小功能,你知道原理就能快速寫出來,而不是引入整個框架。
本文講其中的第一個功能:如何調起手機的相機拍照?
系統現有相機應用
對於如何調用系統現有應用,這里簡單再說一下。在開發的應用中調用系統現有應用,需要使用 Intent 指定開啟的應用的 Action 和 Category,然后通過 startActivity(Intent) 或者 startActivityForResult(Intent, int) 開啟指定的 Activity,如果使用 startActivityForResult() 方法開啟並需要返回值,再重寫 onActivityResult(int, int, Intent) 即可。
先來看看系統現有相機應用的 AndroidManifest.xml 清單文件定義的 Activity:
<activity android:name="com.android.camera.Camera" android:clearTaskOnLaunch="true" android:configChanges="orientation|keyboardHidden" android:screenOrientation="landscape" android:taskAffinity="android.task.camera" android:theme="@android:style/Theme.Black.NoTitleBar.Fullscreen" > <intent-filter> <action android:name="android.intent.action.MAIN" /> <categroy android:name="android.intent.category.DEFAULT" /> <categroy android:name="android.intent.category.LAUNCHER" /> </intent-filter> <intent-filter> <action android:name="android.media.action.IMAGE_CAPTURE" /> <categroy android:name="android.intent.category.DEFAULT" /> </intent-filter> <intent-filter> <action android:name="android.media.action.STILL_IMAGE_CAMERA" /> <categroy android:name="android.intent.category.DEFAULT" /> </intent-filter> </activity> <activity android:name="com.android.camera.VideoCamera" android:clearTaskOnLaunch="true" android:configChanges="origientation|keyboardHidden" android:label="@string/video_camera_label" android:screenOrientation="landscape" android:taskAffinity="android.task.camcorder" android:theme="@android:style/theme.Black.NoTitleBar.Fullscreen" > <intent-filter> <action android:name="android.media.action.VIDEO_CAMERA" /> <categroy android:name="android.intent.category.DEFAULT" /> </intent-filter> <intent-filter> <action android:name="android.media.action.VIDEO_CAPTURE" /> <categroy android:name="android.intent.category.DEFAULT" /> </intent-filter> </activity>
它定義了兩個 Activity,com.android.camera.Camera 表示照相機,com.android.camera.VideoCamera 表示攝像機。從字面意思可以看出,為了捕獲系統相機返回的數據,一般需要使用一下兩個 Action 即可開啟照相機與攝像機:
-
android.media.action.IMAGE_CAPTURE:Intent 的 Action 類型,從現有的相機應用中請求一張圖片。
-
android.media.action.VIDEO_CAPTURE:Intent 的 Action 類型,從現有的相機應用中請求一段視頻。
上面兩個參數,均在 MediaStore 類中以靜態常量的形式定義好了,分別是:MediaStore.ACTION_IMAGE_CAPTURE (相機) 和 MediaStore.ACTION_VIDEO_CAPTURE (攝像機)。
獲取系統現有相機拍攝的圖片
在新開啟的 Activity 中,如果需要獲取它的返回值,則需要使用 startActivityForResult(Intent,int) 方法打開 Activity,並重寫 onActivityResult(int, int, Intent) 獲取系統相機的返回數據,那么我們只需要在 onActivityResult() 中獲取到返回值即可。
系統相機拍攝的照片,如果不指定路徑,會保存在系統默認文件夾下,可以使用 Intent.getExtra() 方法得到,得到的是一個 Uri 地址,表示了一個內容提供者的地址。如果通過MediaStore.EXTRA_OUTPUT 指定了保存路徑,那么通過 Intent.getExtra() 得到的將是一個空地址,但是既然是我們指定的地址,那么也不愁找不到它了。
但是如果是7.0以上,需要使用 FileProvider 來得到這個 uri 地址。
實現方案
說清楚流程之后,下面就是具體代碼實現:
首先是在 AndroidManiFest.xml 下聲明拍照權限:
<uses-permission android:name="android.permission.CAMERA" />
聲明權限后,在開始拍照前,還是需要判斷用戶是否給了我們拍照的權限:
if (( mActivity).checkSelfPermission(Manifest.permission.CAMERA) != PackageManager.PERMISSION_GRANTED) { ActivityCompat.requestPermissions(mActivity, new String[]{Manifest.permission.CAMERA}, GalleryActivity.REQUEST_PERMISSION_CAMERA); } else { imagePicker.takePicture(mActivity, GalleryActivity.REQUEST_CODE_TAKE); }
如果用戶沒有給權限,那么需要申請權限,權限申請以后,會有一個回調通知開發者是否允許了,具體見下發的代碼:
@Override public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) { super.onRequestPermissionsResult(requestCode, permissions, grantResults); if (requestCode == REQUEST_PERMISSION_CAMERA) { if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) { imagePicker.takePicture(this, REQUEST_CODE_TAKE); } else { showToast("權限被禁止,無法打開相機"); } } }
權限允許之后,通過 imagePicker.takePicture 去拍照。下面看下拍照的具體代碼邏輯:
/** * 拍照的方法 */ public void takePicture(Activity activity, int requestCode) { Intent takePictureIntent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE); takePictureIntent.setFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP); if (takePictureIntent.resolveActivity(activity.getPackageManager()) != null) { if (Utils.existSDCard()) takeImageFile = new File(Environment.getExternalStorageDirectory(), "/DCIM/camera/"); else takeImageFile = Environment.getDataDirectory(); takeImageFile = createFile(takeImageFile, "IMG_", ".jpg"); if (takeImageFile != null) { // 默認情況下,即不需要指定intent.putExtra(MediaStore.EXTRA_OUTPUT, uri); // 照相機有自己默認的存儲路徑,拍攝的照片將返回一個縮略圖。如果想訪問原始圖片, // 可以通過dat extra能夠得到原始圖片位置。即,如果指定了目標uri,data就沒有數據, // 如果沒有指定uri,則data就返回有數據! Uri uri; if (VERSION.SDK_INT <= VERSION_CODES.M) { uri = Uri.fromFile(takeImageFile); } else { /** * 7.0 調用系統相機拍照不再允許使用Uri方式,應該替換為FileProvider * 並且這樣可以解決MIUI系統上拍照返回size為0的情況 */ uri = FileProvider.getUriForFile(activity, "com.example.myapplication.provider", takeImageFile); //加入uri權限 要不三星手機不能拍照 List<ResolveInfo> resInfoList = activity.getPackageManager().queryIntentActivities(takePictureIntent, PackageManager.MATCH_DEFAULT_ONLY); for (ResolveInfo resolveInfo : resInfoList) { String packageName = resolveInfo.activityInfo.packageName; activity.grantUriPermission(packageName, uri, Intent.FLAG_GRANT_WRITE_URI_PERMISSION | Intent.FLAG_GRANT_READ_URI_PERMISSION); } } // Log.e("nanchen", ProviderUtil.getFileProviderName(activity)); takePictureIntent.putExtra(MediaStore.EXTRA_OUTPUT, uri); } } activity.startActivityForResult(takePictureIntent, requestCode); }
關於 Intent.resolveActivity 作用,簡單來說就是當你在調用第三方軟件或者系統 Activity,類似打開相機,發送圖片等隱式 Intent,是並不一定能夠在所有的 Android 設備上都正常運行。通過該方法判斷這個 intent 對應的 activity 是否存在,確保不會出現崩潰。
takeImageFile 是圖片存儲地址,在7.0以前,需要用 Uri.fromFile 進行處理。7.0之后的采用 FileProvider。下面介紹下 FileProvider 的使用方法:
注冊
使用 FileProvider 需要在 AndroidManiFest.xml 里聲明:
<provider android:name="android.support.v4.content.FileProvider" android:authorities="com.example.myapplication.provider" android:exported="false" android:grantUriPermissions="true"> <meta-data android:name="android.support.FILE_PROVIDER_PATHS" android:resource="@xml/file_path" /> </provider>
這里是直接使用的 v4 包中的 FileProvider,我們也可以直接繼承 FileProvider 類,適當重寫重載函數,但不建議如此做。下面來介紹上面的幾個設置:
-
name: provider 的類名,若使用默認的 v4 的 FileProvider 可使用 "android.support.v4.content.FileProvider",也可以設置為自定義的繼承 FileProvider 的 provider 類;
-
authorities: 一個簽名認證,可以自定義,但在獲取 uri 的時候需要保持一致;
-
grantUriPermissions: 使用 FileProvider 的使用需要我們給流出的URI 賦予臨時訪問權限(READ 和 WRITE),該設置是允許我們行使該項權力;
-
meta-data: meta-data 配置的是我們可以訪問的文件的路徑配置信息,需要使用 xml 文件進行配置,FileProvider 會通過解析 xml 文件獲取配置項,其中 name 名字不可改變為: android.support.FILE_PROVIDER_PATHS,resource 為配置路徑信息的配置項目。
路徑配置
可訪問的路徑配置可以在 res 中建立一個 xml 文件下面建立一個配置文件,格式如下:
<?xml version="1.0" encoding="utf-8"?> <paths> <!--path:需要臨時授權訪問的路徑(.代表所有路徑)--> <!--name:就是你給這個訪問路徑起個名字--> <external-path name="cam" path="." /> </paths>
下面解釋下:
-
<files-path/> 代表的根目錄: Context.getFilesDir()
- <external-path/> 代表的根目錄: Environment.getExternalStorageDirectory()
- <cache-path/> 代表的根目錄: getCacheDir()
最后,將 uri 放到 MediaStore.EXTRA_OUTPUT 中。
takePictureIntent.putExtra(MediaStore.EXTRA_OUTPUT, uri);
拍照完成后,會回調 onActivityResult,在這里我們可以根據先前傳的值將圖片展示到 ImageView 中:
@Override protected void onActivityResult(int requestCode, int resultCode, Intent data) { Log.i(TAG, "系統相機拍照完成,resultCode=" + resultCode + " " + requestCode); if (requestCode == REQUEST_CODE_TAKE) { Uri uri = Uri.fromFile(takeImageFile); iv_CameraImg.setImageURI(uri); } }
到此,調用系統相機拍照的過程到此就結束了。