Android调用摄像头和相册

很多应用都会用到摄像头或是相册，故记录一下，以便以后作为参考。

随代码附上我的理解。

先说如何调用摄像头：

public class MainActivity extends AppCompatActivity {

    public static final int TAKE_PHOTO = 1;//拍照片
    private static final int CHOOSE_PHOTO = 2;//选择相册中的图片
    private ImageView picture;//放置图片的view
    private Uri imageUri;//图片在手机中存放位置的view

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        Button takePhoto = (Button) findViewById(R.id.take_photo);//拍照按钮
        Button choosePhoto = (Button) findViewById(R.id.choose_from_album);//获取手机中的图片按钮
        picture = (ImageView) findViewById(R.id.picture);
        takePhoto.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                //创建file对象，用于存储拍照后的图片
                File outputImage = new File(getExternalCacheDir(), "output_image.jpg");
                try {
                    if (outputImage.exists()) {
                        outputImage.delete();//如果这个名字的图片存在，那么删除
                    }
                    outputImage.createNewFile();//创建这个file
                } catch (IOException e) {
                    e.printStackTrace();
                }
                if (Build.VERSION.SDK_INT >= 24) {
                //如果Android版本大于7.0
                    imageUri = FileProvider.getUriForFile(MainActivity.this,
                    "com.example.cameraalbum.fileprovider", outputImage);
                } else {
                    imageUri = Uri.fromFile(outputImage);
                }
                //启动相机程序
                Intent intent = new Intent("android.media.action.IMAGE_CAPTURE");
                intent.putExtra(MediaStore.EXTRA_OUTPUT, imageUri);
                startActivityForResult(intent, TAKE_PHOTO);
            }
        });

上面这段代码表示点击拍摄照片的时候的动作，首先创建一个File对象，用于存放拍摄照片的图片，这里是将它放置在了手机的SD卡的应用关联缓存目录下。也就是SD卡中专门用于存放当前缓存数据的位置，使用getExternalCacheDir()即可得到这个位置，因为如果存放在SD卡中，需要进行运行时权限处理才行，而使用应用关联目录则可以跳过这一步。

再下面又进行一个判断，如果版本大于7.0，图片的路径是必须被封装了的，使用FileProvider内容提供器，将被封装过的URI共享给外部，FileProvider中的getUriForFile()方法将File对象转换成一个封装过的uri。这个方法接受三个参数，第一个是Context对象，第二个可以是任意唯一字符串，第三个则是刚创建的File对象。

再下面构建了一个隐式Intent，调用putExtra()方法指定图片的输出地址，也就是刚刚的uri对象。

最后在AndroidManifest.xml中对FileProvider进行注册，如下：

<provider   android:authorities="com.example.cameraalbum.fileprovider"
            android:name="android.support.v4.content.FileProvider"
            android:exported="false"
            android:grantUriPermissions="true" >
            <meta-data
                android:name="android.support.FILE_PROVIDER_PATHS"
                android:resource="@xml/file_paths" />
        provider>

android:authorities必须和刚才在FileProvider.getUriForFile()中的第二个参数一致，meta-data中指定了Uri的共享路径，引用了一个资源。

其中的file_paths.xml内容如下:

<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <external-path name="my_images" path="" />
paths>

external-path 就是用来指定Uri共享的，path表示共享的具体路径这里表示将整个SD卡共享。

显示图片：

/**因为是用startActivityForResult启动的，
所以当拍照这个活动结束销毁之后会调用这个方法*/
@Override
    protected void onActivityResult(int requestCode, int resultCode, Intent data) {
        switch (requestCode) {
            case TAKE_PHOTO:
                if (resultCode == RESULT_OK) {//表示拍照成功
                    try {
                        //将拍照的照片显示出来
                        Bitmap bitmap = BitmapFactory.decodeStream(getContentResolver().
                                openInputStream(imageUri));
                        picture.setImageBitmap(bitmap);
                    } catch (FileNotFoundException e) {
                        e.printStackTrace();
                    }
                }
                break;
            default:
                break;
        }
    }

下面讲如何调用相册里的照片：

choosePhoto.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                if (ContextCompat.checkSelfPermission(MainActivity.this,
                        android.Manifest.permission.WRITE_EXTERNAL_STORAGE) != PackageManager.
                        PERMISSION_GRANTED) {
                    ActivityCompat.requestPermissions(MainActivity.this, new
                            String[]{android.Manifest.permission.WRITE_EXTERNAL_STORAGE}, 1);
                } else {
                    openAlbum();
                }
            }
        });

上面这个按钮监听是放在之前的onCreate方法中的，只是因为要分开讲所以单独拎出来了。

首先在点击要访问相册图片的按钮之后，会先检测用户是否已经允许读取相册，这里的WRITE_EXTERNAL_STORAGE是一个危险权限，因为所有的照片都是存在SD卡中的，所以要从上面读取照片就要申请这个权限。

如果已经同意过就调用openAlbum()方法。如果没同意过就要申请这个权限了，调用ActivityCompat.requestPermissions()方法向用户申请授权，这个方法接受三个参数，第一个是Activity的实例，第二个是一个String数组，把要申请的权限名放在数组中，第三个是请求码，要求是一个唯一值。不管用户选择同意还是拒绝，都要回到onRequestPermissionsResult这个方法中，同意与否的结果在grantResults这个参数中。

下面看一下onRequestPermissionsResult方法：

@Override
    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
        switch (requestCode) {
            case 1:
                if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                    openAlbum();
                } else {
                    Toast.makeText(this, "You denied the permission", Toast.LENGTH_SHORT).show();
                }
                break;
            default:
        }
    }

很明显，在这里判断是否授权成功，成功则调用openAlbum()，失败则跳出一个提示。

下面是openAlbum()的代码：

public void openAlbum() {
        Intent intent = new Intent("android.intent.action.GET_CONTENT");
        intent.setType("image/*");
        startActivityForResult(intent, CHOOSE_PHOTO);//打开相册
    }

和调用摄像头一样，创建一个隐式的Intent来打开相册。
在打开相册这里进行一个判断：

case CHOOSE_PHOTO:
                if(resultCode == RESULT_OK){//已经选择图片成功
                    if(Build.VERSION.SDK_INT >= 19){
                        //4.4及以上系统使用这个方法处理图片
                        handleImageOnKitKat(data);
                    } else {
                        //4.4一下系统使用这个方法处理图片
                        handleImageBeforeKitKat(data);
                    }
                }
                break;

以上代码是放在onActivityResult中的，也是单独拎出来了。这段代码应该能懂，就不过多赘言了。由于4.4以上，选取相册中的图片返回一个封装后的Uri

所以重点看一下handleImageOnKitKat方法是如何解析Uri的：

@TargetApi(19)
    private void handleImageOnKitKat(Intent data) {
        String imagePath = null;
        Uri uri = data.getData();
        if(DocumentsContract.isDocumentUri(this, uri)){
            //如果是document类型的URI，则通过document id 处理
            String docId = DocumentsContract.getDocumentId(uri);
            if("com.android.providers.media.documents".equals(uri.getAuthority())){
                String id = docId.split(":")[1]; //解析出数字格式的id
                String selection = MediaStore.Images.Media._ID + "=" + id;
                imagePath = getImagePath(MediaStore.Images.Media.EXTERNAL_CONTENT_URI,
                        selection);
            } else if("com.android.providers.downloads.documents".equals(uri.getAuthority())){
                Uri contentUri = ContentUris.withAppendedId(Uri.parse("content://downloads/public_downloads"),
                        Long.valueOf(docId));
                imagePath = getImagePath(contentUri, null);
            }
        } else if("content".equalsIgnoreCase(uri.getScheme())){
            //如果是content类型的Uri,则用普通方式处理
            imagePath = getImagePath(uri, null);
        } else if("file".equalsIgnoreCase(uri.getScheme())){
            //如果是file类型的Uri,直接获取图片路径即可
            imagePath = uri.getPath();
        }
        displayImage(imagePath); //根据图片路径显示图片
    }

首先，如果Uri是document类型的话，那么就将取出document id进行处理，如果authority是media格式的话，document id还需要再进行一次解析，通过分割字符串的形式解析出数字格式的id，然后解析出具体位置。

如果Uri是其他格式的，就使用其他方法，上面有注释。
说白了，就是要将document格式的Uri转换为content格式的Uri。

如果版本是4.4以下的，就使用handleImageBeforeKitKat方法：

private void handleImageBeforeKitKat(Intent data){
        Uri uri = data.getData();
        String imagePath = getImagePath(uri, null);
        displayImage(imagePath);
    }

这段代码很简单，也不解释了。

下面是两个方法都有的getImagePath和displayImage方法：

private void displayImage(String imagePath) {
        if(imagePath != null){
            Bitmap bitmap = BitmapFactory.decodeFile(imagePath);
            picture.setImageBitmap(bitmap);
        } else {
            Toast.makeText(this, "获取图片失败，请重试", Toast.LENGTH_SHORT).show();
        }
    }

    private String getImagePath(Uri uri, String selection) {
        String path = null;
        //通过Uri和selection来获取真实的图片路径
        Cursor cursor = getContentResolver().query(uri, null, selection, null, null);
        if(cursor != null){
            if(cursor.moveToFirst()){
                path = cursor.getString(cursor.getColumnIndex(MediaStore.Images.Media.DATA));
            }
            cursor.close();
        }
        return path;
    }

其中的displayImage和之前调用摄像头拍照后显示图片的方法类似，所以也不进行解释了。

而getImagePath作用就是在内容提供器中查找出Uri和符合其约束条件的图片的路径。

以上是Android调用摄像头和相册的大体方法。