拍照

注意：此页面指的是 Camera 类，该类已弃用。我们建议使用 CameraX 或针对特定用例使用 Camera2。CameraX 和 Camera2 均支持 Android 5.0（API 级别 21）及更高版本。

本课程介绍如何通过将工作委托给设备上的其他相机应用来捕获照片。（如果您希望构建自己的相机功能，请参阅控制相机。）

假设您正在实施一项众包天气服务，该服务通过混合运行您的客户端应用的设备拍摄的天空照片来创建全球天气地图。集成照片只是您应用的一小部分。您希望以最少的麻烦拍摄照片，而不是重新发明相机。幸运的是，大多数 Android 设备都已安装至少一个相机应用。在本课程中，您将学习如何让它为您拍照。

请求相机功能

如果应用的核心功能是拍照，则应将应用在 Google Play 上的可见范围限制为具有摄像头的设备。要声明您的应用依赖于摄像头，请在清单文件中添加一个 <uses-feature> 标签。

<manifest ... >
    <uses-feature android:name="android.hardware.camera"
                  android:required="true" />
    ...
</manifest>

如果您的应用使用摄像头，但并非正常运行的必要条件，则将 android:required 设置为 false。这样，Google Play 就会允许没有摄像头的设备下载您的应用。然后，您需要在运行时通过调用 hasSystemFeature(PackageManager.FEATURE_CAMERA_ANY) 来检查摄像头的可用性。如果摄像头不可用，则应禁用您的摄像头功能。

获取缩略图

如果仅仅拍照不是您应用的全部目标，那么您可能希望从相机应用程序获取图像并对其进行处理。

Android 相机应用程序将照片编码在传递给 onActivityResult() 的返回 Intent 中，作为附加信息中的一个小 Bitmap，键名为 "data"。以下代码检索此图像并将其显示在 ImageView 中。

Kotlin

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    if (requestCode == REQUEST_IMAGE_CAPTURE && resultCode == RESULT_OK) {
        val imageBitmap = data.extras.get("data") as Bitmap
        imageView.setImageBitmap(imageBitmap)
    }
}

Java

@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");
        imageView.setImageBitmap(imageBitmap);
    }
}

注意：来自 "data" 的此缩略图图像可能适合用作图标，但除此之外用途不大。处理全尺寸图像需要更多工作。

保存全尺寸照片

如果您为 Android 相机应用程序提供保存文件，它会保存全尺寸照片。您必须提供一个完全限定的文件名，指定相机应用应将照片保存到的位置。

通常，用户使用设备摄像头拍摄的任何照片都应保存在设备的公共外部存储中，以便所有应用都能访问。共享照片的正确目录由 getExternalStoragePublicDirectory() 提供，并使用 DIRECTORY_PICTURES 参数。此方法提供的目录在所有应用之间共享。在 Android 9（API 级别 28）及更低版本上，读取和写入此目录分别需要 READ_EXTERNAL_STORAGE 和 WRITE_EXTERNAL_STORAGE 权限。

<manifest ...>
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    ...
</manifest>

在 Android 10（API 级别 29）及更高版本上，共享照片的正确目录是 MediaStore.Images 表。您无需声明任何存储权限，只要您的应用只需要访问用户使用您的应用拍摄的照片即可。

但是，如果您希望照片仅对您的应用私有，则可以使用 Context.getExternalFilesDir() 提供的目录。在 Android 4.3 及更低版本上，写入此目录也需要 WRITE_EXTERNAL_STORAGE 权限。从 Android 4.4 开始，不再需要此权限，因为其他应用无法访问此目录，因此您可以通过添加 maxSdkVersion 属性来声明仅在较低版本的 Android 上请求此权限。

<manifest ...>
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"
                     android:maxSdkVersion="28" />
    ...
</manifest>

注意：当用户卸载您的应用时，保存在 getExternalFilesDir() 或 getFilesDir() 提供的目录中的文件将被删除。

确定文件目录后，您需要创建一个防冲突的文件名。您可能还希望将路径保存在成员变量中以供以后使用。以下是在方法中返回新照片唯一文件名（使用日期时间戳）的示例解决方案。（此示例假设您从 Context 内部调用该方法。）

Kotlin

lateinit var currentPhotoPath: String

@Throws(IOException::class)
private fun createImageFile(): File {
    // Create an image file name
    val timeStamp: String = SimpleDateFormat("yyyyMMdd_HHmmss").format(Date())
    val storageDir: File = getExternalFilesDir(Environment.DIRECTORY_PICTURES)
    return File.createTempFile(
            "JPEG_${timeStamp}_", /* prefix */
            ".jpg", /* suffix */
            storageDir /* directory */
    ).apply {
        // Save a file: path for use with ACTION_VIEW intents
        currentPhotoPath = absolutePath
    }
}

Java

String currentPhotoPath;

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: path for use with ACTION_VIEW intents
    currentPhotoPath = image.getAbsolutePath();
    return image;
}

有了此方法来创建照片文件，您现在可以创建并调用 Intent，如下所示。

Kotlin

private fun dispatchTakePictureIntent() {
    Intent(MediaStore.ACTION_IMAGE_CAPTURE).also { takePictureIntent ->
        // Ensure that there's a camera activity to handle the intent
        takePictureIntent.resolveActivity(packageManager)?.also {
            // Create the File where the photo should go
            val photoFile: File? = try {
                createImageFile()
            } catch (ex: IOException) {
                // Error occurred while creating the File
                ...
                null
            }
            // Continue only if the File was successfully created
            photoFile?.also {
                val photoURI: Uri = FileProvider.getUriForFile(
                        this,
                        "com.example.android.fileprovider",
                        it
                )
                takePictureIntent.putExtra(MediaStore.EXTRA_OUTPUT, photoURI)
                startActivityForResult(takePictureIntent, REQUEST_IMAGE_CAPTURE)
            }
        }
    }
}

Java

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) {
        // Create the File where the photo should go
        File photoFile = null;
        try {
            photoFile = createImageFile();
        } catch (IOException ex) {
            // Error occurred while creating the File
            ...
        }
        // Continue only if the File was successfully created
        if (photoFile != null) {
            Uri photoURI = FileProvider.getUriForFile(this,
                                                  "com.example.android.fileprovider",
                                                  photoFile);
            takePictureIntent.putExtra(MediaStore.EXTRA_OUTPUT, photoURI);
            startActivityForResult(takePictureIntent, REQUEST_IMAGE_CAPTURE);
        }
    }
}

注意：我们使用的是 getUriForFile(Context, String, File)，它返回一个 content:// URI。对于面向 Android 7.0（API 级别 24）及更高版本的较新应用，跨包边界传递 file:// URI 会导致 FileUriExposedException。因此，我们现在提供了一种使用 FileProvider 存储图像的更通用方法。

现在，您需要配置 FileProvider。在您的应用清单中，向您的应用程序添加一个提供程序。

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

确保 authorities 字符串与传递给 getUriForFile(Context, String, File) 的第二个参数匹配。在提供程序定义的元数据部分，您可以看到提供程序期望在专用资源文件中配置合格路径，res/xml/file_paths.xml。以下是此特定示例所需的内容。

<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <external-files-path name="my_images" path="Pictures" />
</paths>

路径组件对应于使用 Environment.DIRECTORY_PICTURES 调用 getExternalFilesDir() 时返回的路径。确保将 com.example.package.name 替换为您应用的实际包名。此外，请查看 FileProvider 的文档，以了解除了 external-path 之外还可以使用的路径说明符。

将照片添加到图库

通过 Intent 创建照片时，您应该知道图像位于何处，因为您一开始就指定了保存位置。对于其他人来说，使照片可访问的最简单方法可能是使其可从系统的媒体提供程序访问。

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

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

Kotlin

private fun galleryAddPic() {
    Intent(Intent.ACTION_MEDIA_SCANNER_SCAN_FILE).also { mediaScanIntent ->
        val f = File(currentPhotoPath)
        mediaScanIntent.data = Uri.fromFile(f)
        sendBroadcast(mediaScanIntent)
    }
}

Java

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

解码缩放后的图像

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

Kotlin

private fun setPic() {
    // Get the dimensions of the View
    val targetW: Int = imageView.width
    val targetH: Int = imageView.height

    val bmOptions = BitmapFactory.Options().apply {
        // Get the dimensions of the bitmap
        inJustDecodeBounds = true

        BitmapFactory.decodeFile(currentPhotoPath, bmOptions)

        val photoW: Int = outWidth
        val photoH: Int = outHeight

        // Determine how much to scale down the image
        val scaleFactor: Int = Math.max(1, Math.min(photoW / targetW, photoH / targetH))

        // Decode the image file into a Bitmap sized to fill the View
        inJustDecodeBounds = false
        inSampleSize = scaleFactor
        inPurgeable = true
    }
    BitmapFactory.decodeFile(currentPhotoPath, bmOptions)?.also { bitmap ->
        imageView.setImageBitmap(bitmap)
    }
}

Java

private void setPic() {
    // Get the dimensions of the View
    int targetW = imageView.getWidth();
    int targetH = imageView.getHeight();

    // Get the dimensions of the bitmap
    BitmapFactory.Options bmOptions = new BitmapFactory.Options();
    bmOptions.inJustDecodeBounds = true;

    BitmapFactory.decodeFile(currentPhotoPath, bmOptions);

    int photoW = bmOptions.outWidth;
    int photoH = bmOptions.outHeight;

    // Determine how much to scale down the image
    int scaleFactor = Math.max(1, Math.min(photoW/targetW, photoH/targetH));

    // Decode the image file into a Bitmap sized to fill the View
    bmOptions.inJustDecodeBounds = false;
    bmOptions.inSampleSize = scaleFactor;
    bmOptions.inPurgeable = true;

    Bitmap bitmap = BitmapFactory.decodeFile(currentPhotoPath, bmOptions);
    imageView.setImageBitmap(bitmap);
}