Android 相机使用教程（一）

Android 框架提供对设备上可用的相机和各种相机功能的支持，通过它我们可以在应用程序中拍摄图片和视频。本文将介绍一种快速，简单的拍摄图像和视频方法，并概述创建自定义相机的高级用法。

你还在为开发中频繁切换环境打包而烦恼吗？快来试试 Environment Switcher 吧！使用它可以在app运行时一键切换环境，而且还支持其他贴心小功能，有了它妈妈再也不用担心频繁环境切换了。https://github.com/CodeXiaoMai/EnvironmentSwitcher

注意：Camera类已被弃用，官方建议使用更新的 android.hardware.camera2，但是它适用于Android 5.0（API级别21）或更高版本，所以...... 你懂的。

前言

在拍摄照片和视频之前，首先我们应该考虑一些关于我们的应用程序应该如何使用相机的问题。

• 相机的必要性 - 相机对我们的应用程序是否非常重要？我们的应用程序是否不允许安装在没有相机的设备上？如果是这样，我们应该在 manifest 中声明对相机的要求。

• 快速拍照还是自定义相机 - 我们的应用程序将如何使用相机？我们是只想快速的拍摄图片或视频剪辑，还是提供新的方式使用相机？如果是想快速的拍摄图片或剪辑，我们应该考虑使用现有的相机应用程序（系统已经提供默认的相机应用）。而要开发定制的相机功能，我们应该创建自己的相机应用程序部分。

• 存储 - 我们的应用程序生成的图像或视频是仅在我们的应用程序中可见，还是为了方便其他应用程序（如Gallery或其他媒体和社交应用程序）使用它们？如果我们的应用程序被卸载，是否希望图片和视频仍然可用？

相关基础内容

Android框架支持通过android.hardware.camera2 API或 Intent 启动摄像机 两种方式捕获图像和视频。以下是我们需要用到的类：

• android.hardware.camera2
  这是用于控制设备摄像机的主要API。当我们创建相机应用程序时，可用于拍摄照片或视频。

• Camera
  这个类是用于控制设备摄像头的旧版API（已经被废弃）。

• SurfaceView
  这个类用于呈现实时相机预览。

• MediaRecorder
  该类用于记录相机录制的视频。

• Intent
  使用 MediaStore.ACTION_IMAGE_CAPTURE 可用于捕获图像，而使用 MediaStore.ACTION_VIDEO_CAPTURE 可用于拍摄视频。这两个 Intent 是为了方便我们直接调用其他相机应用进行拍照或录制视频，而不用直接使用Camera对象。

清单声明

在使用Camera API开始开发应用程序之前，我们首先应该正确的配置 manifest，以允许使用相机硬件和其他相关功能。

• 相机权限 - 如果我们通过调用现有的相机应用程序来使用相机，则应用程序不需要请求此权限，反之如果是自定义相机则我们的应用程序必须要求使用设备摄像头的权限。

• 相机功能 - 我们的应用程序还必须声明使用相机功能

将相机功能添加到 manifest 中会导致Google Play阻止我们的应用程序安装到没有相机或不支持我们所指定的相机功能的设备上。

如果我们的应用程序的核心功能为拍摄照片，或者如果设备没有相机则应用无法运行，我们可以通过上面的代码将其在应用商店（Google Play）上的可见性限制为具有相机的设备。而如果我们的应用程序有一部分功能需要相机，但并非必须需要相机才能运行（其他功能还是可以用的嘛），则应将 manifest 中的 android:required 设置为 false，否则会导致设备没有相机的用户无法安装此应用。

    
    ...

• 存储权限 - 如果我们的应用程序需要将图像或视频保存到设备的外部存储（SD卡），则还必须在 manifest 中添加：

• 录音权限** - 对于使用视频捕获录制音频，我们的应用程序必须请求音频捕获权限。

• 定位权限 - 如果我们的应用程序使用GPS位置信息标记图像，则必须请求ACCESS_FINE_LOCATION权限。需要注意的是，如果我们的应用运行在Android 5.0（API级别21）或更高版本，则还需要声明使用设备的GPS：

  
  ...
  
  
  

使用现有相机应用拍摄照片

通过Intent来调用现有的相机应用程序，可以快速地实现在应用程序中拍摄照片或视频，这是最简单快速的方法。

通过现有的相机应用程序来实现拍照这个过程涉及 3 个步骤：创建 Intent、启动已有相机应用 以及返回到我们的 Activity 时处理图像数据。

1. 创建 Intent 并启动相机应用

这是一个通过 Intent 启动系统相机的例子:

static final int REQUEST_IMAGE_CAPTURE = 1;

private void dispatchTakePictureIntent() {
    Intent takePictureIntent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);
    if (takePictureIntent.resolveActivity(getPackageManager()) != null) {
        startActivityForResult(takePictureIntent, REQUEST_IMAGE_CAPTURE);
    }
}

请注意，startActivityForResult（）方法受到调用resolveActivity（）的条件的保护，resolveActivity（）方法返回可处理该intent的第一个活动组件。执行此检查很重要，因为如果我们使用一个没有应用程序可以响应的 Intent 调用startActivityForResult（），程序将会崩溃。所以只要结果不为空，就可以安全的使用它。

2. 处理图像数据

当使用相机应用程序拍照成功后，系统会将照片进行编码放入返回的 Intent 中并传递给onActivityResult（）。

2.1 获取缩略图

Intent 的 extras 中的 “data” 关键字 存储的就是缩略图。以下代码是从返回结果中取出此图像并将其显示在ImageView中。

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    if (requestCode == REQUEST_IMAGE_CAPTURE && resultCode == RESULT_OK) {
        Bundle extras = data.getExtras();
        Bitmap imageBitmap = (Bitmap) extras.get("data");
        mImageView.setImageBitmap(imgetBitmap);
    }
}

注意：来自“data”的缩略图可能对像素要求不高的图片很适合。处理全尺寸图像需要更多的工作。

2.2 保存全尺寸照片

显然仅仅用缩略图是不能满足我们的要求的，我们可以用一个文件来保存一张全尺寸照片。

通常，用户使用摄像头拍摄的照片应保存在公共外部存储设备上，以便所有应用都可以访问。调用 Environment.getExternalStoragePublicDirectory（）并传递参数DIRECTORY_PICTURES 将返回共享照片的正确目录。由于此方法提供的目录在所有应用程序之间共享，所以读取和写入需要分别具有READ_EXTERNAL_STORAGE 和 WRITE_EXTERNAL_STORAGE权限。写入权限隐含地允许读取，所以如果你需要写入外部存储，那么你只需要请求一个权限：

    
    ...

但是，如果我们希望照片仅对我们自己的应用程序保持私有状态，则可以使用getExternalFilesDir（）提供的目录。在Android 4.3及更低版本上，写入此目录也需要 WRITE_EXTERNAL_STORAGE 权限。从Android 4.4开始，不再需要权限，因为目录不能被其他应用程序访问，因此我们可以通过添加maxSdkVersion属性来声明仅在较低版本的Android上的权限：

    
    ...

注意：当用户卸载应用程序时，系统将删除由getExternalFilesDir（）或 getFilesDir（）提供的目录中保存的文件。

确定文件的目录后，我们需要创建一个防止冲突的文件名。我们可能还希望将路径保存在成员变量中以备以后使用。以下是使用日期时间戳作为新照片的唯一文件名的方法的示例解决方案：

String mCurrentPhotoPath;

private File createImageFile() throws IOException {
    // Create an image file name
    String timeStamp = new SimpleDateFormat("yyyyMMdd_HHmmss").format(new Date());
    String imageFileName = "JPEG_" + timeStamp + "_";
    File storageDir = getExternalFilesDir(Environment.DIRECTORY_PICTURES);
    File image = File.createTempFile(
            imageFileName, /* prefix */
            ".jpg",        /* suffix */
            storageDir     /* directory */
    );

    // Save a file: 用于ACTION_VIEW意图的路径
    mCurrentPhotoPath = image.getAbsolutePath();
    return image;
}

使用这种方法可以为照片保存为一个文件，现在可以像这样创建和调用Intent：

public static final int REQUEST_TAKE_PHOTO = 1;

private void dispatchTakePictureIntent() {
    Intent takePictureIntent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);
    // Ensure that there's a camera activity to handle the intent
    if (takePictureIntent.resolveActivity(getPackageManager()) != null) {
        File photoFile = null;
        try {
            // Create the File where the photo should go
            photoFile = createImageFile();
        } catch (IOException e) {
            e.printStackTrace();
        }
        // Continue only if the File was successfully created
        if (photoFile != null) {
            Uri photoURI = FileProvider.getUriForFile(this,
                    "com.xiaomai.myproject.fileprovider",
                    photoFile
            );
            takePictureIntent.putExtra(MediaStore.EXTRA_OUTPUT, photoURI);
            startActivityForResult(takePictureIntent, REQUEST_TAKE_PHOTO);
        }
    }
}

注意：我们使用getUriForFile（Context，String，File）返回一个content:// URI。对于Android 7.0和更高（API等级大于等于24）的应用，通过一个包边界传递一个file:// URI会导致FileUriExposedException。因此，我们现在介绍一种使用FileProvider存储图像的更通用的方法。

现在，我们需要配置FileProvider。在应用的清单中，为我们的应用添加一个提供者：

   ...
   
        
    
    ...

确保android:authorities的字符串内容匹配 getUriForFile（Context，String，File）的第二个参数。在提供程序定义的元数据部分，我们可以看到提供程序期望在专用资源文件res/xml/file_paths.xml中配置符合条件的路径。以下是此特定示例所需的内容：

路径组件对应于调用getExternalFilesDir() 并使用Environment.DIRECTORY_PICTURES时返回的路径。确保你已经将com.example.package.name替换为应用程序的实际包名称。另外，可以查看FileProvider的文档，以便使用除了外部路径之外的路径说明符。

将照片添加到图库

当通过 Intent 启动拍摄照片时，我们知道图像所在的位置，因为我们指定了将其保存在哪里。对于其他人来说，也许最简单的方法是使我们的照片可以访问，使其可以从系统的媒体访问。

注意：如果我们将照片保存到由getExternalFilesDir（）提供的目录中，则媒体扫描程序无法访问这些文件，因为它们对我们的应用程序是私有的。

以下示例方法演示了如何调用系统的媒体扫描程序将我们的照片添加到媒体提供商的数据库，使其可以在Android图库应用程序和其他应用程序中使用。

private void galleryAddPic() {
    Intent mediaScanIntent = new Intent(Intent.ACTION_MEDIA_SCANNER_SCAN_FILE);
    File file = new File(mCurrentPhotoPath);
    Uri contentUri = Uri.fromFile(file);
    mediaScanIntent.setData(contentUri);
    sendBroadcast(mediaScanIntent);
}

解码缩放图片

使用有限的内存来管理多个全尺寸图像可能很棘手。如果在仅仅显示几个图像后就发现应用程序内存不足，则可以通过将JPEG缩放到匹配目标视图大小并存入内存中，来大大减少动态堆的使用数量。以下示例方法演示了此技术。

private void setPic() {
    // 获取ImageView的尺寸
    int targetWidth = mImageView.getWidth();
    int targetHeight = mImageView.getHeight();

    // 获取图片的真实尺寸
    BitmapFactory.Options bmOptions = new BitmapFactory.Options();
    bmOptions.inJustDecodeBounds = true;
    BitmapFactory.decodeFile(mCurrentPhotoPath, bmOptions);
    int photoWidth = bmOptions.outWidth;
    int photoHeight = bmOptions.outHeight;

    // 确定图像的缩放比例
    int scaleFactor = Math.min(photoWidth / targetWidth, photoHeight / targetHeight);

    // 将图像文件解码为位图大小以填充视图
    bmOptions.inJustDecodeBounds = false;
    bmOptions.inSampleSize = scaleFactor;
    bmOptions.inPurgeable = true;

    Bitmap bitmap = BitmapFactory.decodeFile(mCurrentPhotoPath, bmOptions);
    mImageView.setImageBitmap(bitmap);
}