Android 调起系统相机拍照

时间:2022-05-12 06:05:16

概述

最近在看 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);
        } 
    }

到此,调用系统相机拍照的过程到此就结束了。