Android Camera2 API实践：实现预览与图像数据捕获

最新推荐文章于 2025-04-14 08:30:00 发布

Ga Ou

最新推荐文章于 2025-04-14 08:30:00 发布

阅读量2.6k

点赞数 29

本文链接：https://blog.csdn.net/weixin_42502089/article/details/144096442

版权

本文还有配套的精品资源，点击获取

简介：介绍了在Android 5.0及以上版本中使用Camera2 API进行相机预览和图像数据捕获的方法。从基础概念到预览设置，再到图像数据的获取和处理，详细阐述了Camera2 API的核心组件和功能，以及如何通过实战示例学习和应用这些技术。 camera2

1. Camera2 API基础介绍

1.1 Camera2 API的作用与优势

Camera2 API是Android平台上用于控制相机硬件的先进接口，它提供了比旧版Camera API更丰富、更精细的控制能力。开发者可以使用Camera2 API来控制高级摄影功能，比如手动曝光、手动对焦、raw图像捕获等。这样的灵活性使得开发者能创建出更专业、更符合用户需求的拍照应用。

1.2 Camera2 API与旧版Camera API的区别

与旧版的Camera API相比，Camera2 API具有诸多改进之处。首先，Camera2 API对摄像头硬件的操作提供了更细粒度的控制，从初始化到捕获过程的每一帧，都能进行精细的调整。其次，Camera2 API支持更高分辨率的图像捕获，以及更广泛的图像格式。此外，Camera2 API引入了异步回调机制，从而提供更低延迟的预览和捕获体验，这对于追求高质量用户体验的应用来说是一个显著的提升。

1.3 Camera2 API的核心概念和架构

Camera2 API的核心概念包括CameraDevice、CameraCaptureSession、CaptureRequest等。CameraDevice代表了具体的相机硬件，而CameraCaptureSession则用于管理与相机硬件的会话，并负责发送捕获请求。CaptureRequest则用于定义一次捕获的详细设置，比如曝光、ISO、白平衡等。Camera2 API的架构是高度模块化的，允许开发者根据自己的需求进行灵活配置和使用。通过理解这些核心组件和它们之间的交互方式，开发者可以更好地利用Camera2 API的功能来实现复杂和高度定制化的相机应用。

2. 摄像头获取与预览设置

2.1 摄像头权限的申请与管理

在Android平台上开发涉及摄像头的应用时，权限管理是首当其冲的重要部分。无论是为了遵循Google Play的政策还是为了用户数据的安全，正确地处理用户权限是开发过程中不可或缺的一环。

2.1.1 用户权限请求与处理

为了使用摄像头，应用需要请求用户授予摄像头访问权限。这一过程通常发生在运行时，即应用运行时向用户请求必要的权限。以下是一段示例代码，展示如何检查并请求摄像头权限：

if (ContextCompat.checkSelfPermission(thisActivity, Manifest.permission.CAMERA)
        != PackageManager.PERMISSION_GRANTED) {
    // Permission is not granted
    ActivityCompat.requestPermissions(thisActivity,
            new String[]{Manifest.permission.CAMERA},
            MY_PERMISSIONS_REQUEST_CAMERA);
}

在上述代码中， ContextCompat.checkSelfPermission 用于检查应用是否已经获得了摄像头权限， requestPermissions 方法则是当应用未获得权限时向用户申请权限的函数。

2.1.2 系统权限的声明与获取

除了在代码中动态请求外，还需要在AndroidManifest.xml文件中声明需要的权限。例如：

<uses-permission android:name="android.permission.CAMERA" />

如果您的应用面向Android 6.0（API 级别 23）或更高版本，必须在运行时请求权限。当用户授予权限后，系统会调用 onRequestPermissionsResult 方法。您的应用需要实现此方法以正确处理用户的响应。

2.2 摄像头设备的枚举与选择

摄像头设备的枚举和选择是构建任何摄像头应用的基础，它涉及到如何在多个摄像头设备中选择最合适的设备供用户使用。

2.2.1 遍历可用摄像头设备

首先，我们需要遍历设备上所有的摄像头，并获得它们的详细信息。以下是使用Camera2 API遍历摄像头设备的代码段：

CameraManager manager = (CameraManager) getSystemService(Context.CAMERA_SERVICE);
for (String cameraId : manager.getCameraIdList()) {
    CameraCharacteristics characteristics = manager.getCameraCharacteristics(cameraId);
    // 获取摄像头的详细信息
    Integer facing = characteristics.get(CameraCharacteristics.LENS_FACING);
    if (facing != null && facing == CameraCharacteristics.LENS_FACING_FRONT) {
        // 此处添加代码选择前摄像头设备
    }
}

2.2.2 根据需要选择合适的摄像头

摄像头的种类可能非常多，包括前后摄像头、深度摄像头等，我们需要根据应用需求来选择最合适的摄像头。例如，如果应用需要进行人脸识别，那么通常会选用前摄像头。

2.3 摄像头预览参数的配置

配置摄像头预览参数是实现个性化预览体验的关键，参数的合理设置能够影响预览的流畅度和质量。

2.3.1 设置预览大小和格式

预览的尺寸和格式直接关系到用户所见的预览效果和性能。以下代码展示了如何设置预览尺寸和格式：

CameraCharacteristics characteristics = manager.getCameraCharacteristics(cameraId);
StreamConfigurationMap map = characteristics.get(CameraCharacteristics.SCALER_STREAM_CONFIGURATION_MAP);
Size[] previewSizes = map.getOutputSizes(SurfaceTexture.class);

// 假设我们选择的预览大小为1080x1920
Size previewSize = new Size(1080, 1920);

2.3.2 预览帧率的调整和限制

预览帧率的调整是平衡设备性能和用户体验的重要手段。过高的帧率会导致设备负荷增加，而过低的帧率则会影响用户体验。

// 设置期望的帧率范围
int[] frameRates = map.getOutputMinFrameDuration(SurfaceTexture.class, previewSize);
int minFps = frameRates[0];
int maxFps = frameRates[1];
// 根据设备性能调整实际帧率
int actualFps = Math.min(Math.max(minFps, desiredFps), maxFps);

在上述代码中，首先获取预览大小对应的最小和最大帧率，然后在允许的范围内根据应用需求选择合适的帧率。

表格展示不同预览尺寸与帧率的组合对性能的影响：

| 预览尺寸（像素） | 最小帧率（fps） | 最大帧率（fps） | |------------------|-----------------|-----------------| | 1280x720 | 30 | 60 | | 1080x1920 | 24 | 48 | | 1920x1080 | 15 | 30 |

通过表格可以清晰看到，预览尺寸和帧率对设备性能的要求。开发者可以根据表格信息和应用需求进行合理的预览参数配置。

通过本章节的介绍，我们了解了摄像头权限申请与管理、摄像头设备的枚举与选择以及预览参数的配置等核心内容。这些内容为后续章节中进行高级配置和应用开发打下了坚实的基础。接下来，我们将进一步深入探讨如何创建和配置预览Surface，从而将摄像头的实时画面展示给用户。

3. 预览Surface的创建与配置

在第三章中，我们将深入探讨如何在Android应用中创建和配置用于Camera2 API的预览Surface。预览Surface是显示摄像头预览画面的关键组件，本章将涵盖从创建Surface到绑定预览流的整个流程，并说明如何管理和更新动态Surface。

3.1 Surface的创建与预览流的绑定

3.1.1 创建Surface用于显示预览

为了在Android应用中显示摄像头预览，首先需要创建一个Surface。在Camera2 API中，可以使用 SurfaceView 或 TextureView 来显示预览。以下代码展示了如何使用 TextureView 创建一个用于预览的Surface：

TextureView textureView = (TextureView) findViewById(R.id.texture_view);
textureView.setSurfaceTextureListener(new TextureView.SurfaceTextureListener() {
    @Override
    public void onSurfaceTextureAvailable(SurfaceTexture surface, int width, int height) {
        // 当Surface可用时，配置摄像头并开始预览
        setupCameraAndStartPreview(surface);
    }

    @Override
    public void onSurfaceTextureSizeChanged(SurfaceTexture surface, int width, int height) {
        // 处理Surface尺寸变化
    }

    @Override
    public boolean onSurfaceTextureDestroyed(SurfaceTexture surface) {
        // 表面被销毁时，释放资源
        return true;
    }

    @Override
    public void onSurfaceTextureUpdated(SurfaceTexture surface) {
        // 表面被更新时的回调
    }
});

在上述代码中，我们为 TextureView 设置了 SurfaceTextureListener ，其中 onSurfaceTextureAvailable 回调会在Surface准备好时被调用。在这时，我们可以开始配置摄像头并启动预览。

3.1.2 将预览流与Surface绑定

在获取到可用的Surface之后，我们需要将其与摄像头预览流绑定。这可以通过 CameraDevice 和 CaptureRequest.Builder 来完成。下面的代码段展示了如何将Surface与摄像头预览流绑定：

private void setupCameraAndStartPreview(SurfaceTexture surface) {
    try {
        // 创建CaptureRequest.Builder实例，用于构建预览请求
        CaptureRequest.Builder previewBuilder = mCameraDevice.createCaptureRequest(CameraDevice.TEMPLATE_PREVIEW);
        // 将Surface添加到预览请求中
        previewBuilder.addTarget(surface);

        // 开始摄像头预览
        mCameraDevice.createCaptureSession(Arrays.asList(surface), new CameraCaptureSession.StateCallback() {
            @Override
            public void onConfigured(CameraCaptureSession session) {
                // 当预览会话配置成功时，提交预览请求
                session.setRepeatingRequest(previewBuilder.build(), null, null);
            }

            @Override
            public void onConfigureFailed(CameraCaptureSession session) {
                // 配置失败时的处理
            }
        }, mBackgroundHandler);
    } catch (CameraAccessException e) {
        // 处理摄像头访问异常
    }
}

在上面的代码段中，我们首先创建了一个 CaptureRequest.Builder 的实例，并通过 addTarget 方法将Surface添加到预览构建器中。然后，我们创建了一个 CameraCaptureSession 并通过 setRepeatingRequest 方法开始周期性地提交预览请求。

3.2 Surface的管理与更新

3.2.1 监听Surface状态变化

Surface的状态可能会因为各种原因发生变化，例如，当用户按下Home键或应用进入后台时，Surface可能会被系统销毁。因此，需要对Surface的状态变化进行监听，以便在应用需要时正确地处理这些变化。这可以通过 SurfaceTextureListener 中的 onSurfaceTextureDestroyed 和 onSurfaceTextureSizeChanged 回调实现。

3.2.2 动态Surface的配置更新

在某些情况下，可能需要根据应用的需要动态地更新Surface的配置。例如，用户在应用内调整了预览窗口的大小，或者摄像头的某些参数发生了变化。在这些情况下，需要重新绑定或更新Surface配置。以下是如何在运行时更新Surface配置的示例代码：

private void updateSurfaceConfiguration(SurfaceTexture newSurface) {
    // 停止当前的捕获会话
    mCaptureSession.stopRepeating();
    // 移除旧的Surface并添加新的Surface
    try {
        mCaptureSession.setRepeatingRequest(
            mPreviewRequestBuilder.build(),
            null,
            mBackgroundHandler);
    } catch (CameraAccessException e) {
        // 处理摄像头访问异常
    }
}

在上述代码中，首先停止了当前的捕获会话，然后更新了Surface配置，并重新开始了预览请求。这样的操作确保了预览窗口可以适应Surface的变化。

通过本章的介绍，我们已经了解了如何创建和配置用于Camera2 API的预览Surface，以及如何管理动态Surface。这些知识对于实现流畅的摄像头预览功能至关重要。在接下来的章节中，我们将继续探索构建CaptureSession和发送预览请求的详细步骤，使我们能更全面地掌握Camera2 API的使用。

4. CaptureSession的构建与预览请求的发送

4.1 CaptureSession的初始化与配置

4.1.1 创建CaptureSession实例

在深入探讨如何构建 CaptureSession 实例之前，有必要先理解 CaptureSession 是什么。 CaptureSession 是Camera2 API中的一个核心概念，用于控制相机的捕获操作。它是一个会话，用于将预览、录制、静态图片捕获等功能结合起来，协调它们的执行。在Camera2中，几乎所有的捕获操作都是通过 CaptureSession 来进行的。

创建 CaptureSession 实例的代码如下所示：

// 创建CameraDevice实例后，进行Session的创建
CameraCaptureSession mCaptureSession = null;

// 构建一个列表，列出我们想要与CaptureSession关联的输出目标
List<Surface> outputs = new ArrayList<>();
outputs.add(previewSurface); // 假设previewSurface是有效的Surface实例

// 开始创建Session
mCameraDevice.createCaptureSession(outputs, new CameraCaptureSession.StateCallback() {
    @Override
    public void onConfigured(CameraCaptureSession session) {
        // 当Session配置完成时，此回调会被触发。
        mCaptureSession = session;
        // 这里可以发送预览请求等操作。
    }

    @Override
    public void onConfigureFailed(CameraCaptureSession session) {
        // 如果配置失败，将无法开始捕获。
        // 此处可以进行错误处理。
    }
}, mBackgroundHandler);

参数说明： - outputs : 这是一个 Surface 的列表，包含了一个或多个需要在 CaptureSession 中使用的 Surface 实例。 - StateCallback : 这是一个回调接口，它定义了几个重要的方法，比如 onConfigured 和 onConfigureFailed ，用于接收Session配置成功与否的通知。

逻辑分析：在这段代码中，我们首先创建了一个 CameraCaptureSession.StateCallback 实例，定义了处理 CaptureSession 配置成功或失败的回调函数。接着，我们使用 CameraDevice.createCaptureSession 方法创建 CaptureSession ，传入了输出目标列表和状态回调。在 onConfigured 回调函数中，我们可以得到一个配置好的 CaptureSession 实例，并可以开始发送请求，如预览请求。

4.1.2 配置Session的输出目标

在 onConfigured 回调中，一旦我们获得了配置好的 CaptureSession 实例，下一步就是设置输出目标。输出目标可以是屏幕预览、视频录制输出、图像捕获等，每一个输出目标都对应一个 Surface 对象。

设置 CaptureSession 输出目标的代码如下：

// 假设我们已经创建了CaptureSession实例和相应的Surface
// 下面的代码应当在onConfigured()回调函数内执行

try {
    // 开始配置CaptureSession的输出目标
    mCaptureSession.setRepeatingRequest(request, null, mBackgroundHandler);
} catch (CameraAccessException e) {
    // 处理可能出现的CameraAccessException异常
}

参数说明： - request : 是一个 CaptureRequest 对象，它表示一个请求，指示相机应该以何种方式捕获一帧图像。 setRepeatingRequest 方法将这个请求配置为重复执行，从而实现连续的预览。 - null : 这是 CaptureCallback 的占位符，如果需要接收每个单独捕获请求的回调，则可以传入一个有效的 CaptureCallback 实例。在这里我们不需要，所以传入 null 。

逻辑分析： setRepeatingRequest 方法用于设置一个重复执行的捕获请求，例如连续的视频预览。这个方法接受三个参数：捕获请求、回调函数以及一个 Handler 。在上述代码中， null 代表我们不需要为单个捕获事件接收回调。如果捕获请求成功配置，将开始连续预览。如果在请求配置过程中出现异常，比如 CameraAccessException ，则需要进行异常处理。

CaptureSession 与输出目标的配置是实现相机应用功能的关键一步，它确保了图像数据可以流向正确的方向，例如屏幕预览或文件存储等。接下来的章节，我们将探讨如何构建预览请求并发送管理这些请求。

5. ImageReader的使用与图像数据处理

5.1 ImageReader基础与配置

5.1.1 ImageReader的工作原理

ImageReader是Android中的一个类，专门用于处理图像数据的捕获。通过ImageReader，应用程序能够高效地从摄像头预览中捕获帧，并将其转换为图像缓冲区，以便进行进一步的处理。ImageReader在内部使用生产者-消费者模型，其中摄像头作为生产者，应用程序作为消费者。它允许应用程序以同步或异步的方式从摄像头接收连续的图像帧。

5.1.2 创建ImageReader实例并配置参数

使用ImageReader时，首先需要创建一个ImageReader实例，该实例将定义所期望的图像大小和格式。例如，如果你希望捕获YUV格式的图像，大小为1280x720像素，你可以这样做：

ImageReader imageReader = ImageReader.newInstance(1280, 720, PixelFormat.YUV_420_888, 2);

这段代码创建了一个ImageReader实例，它将提供两个缓冲区（缓冲区的数量由最后一个参数决定），每个缓冲区包含YUV格式的图像数据。

5.2 图像数据的捕获与处理

5.2.1 同步捕获图像帧

在ImageReader创建之后，你可以将其与一个CaptureSession绑定，并注册一个ImageAvailableListener监听器来接收图像帧。当缓冲区可用时，监听器的onImageAvailable方法会被调用：

imageReader.setOnImageAvailableListener(new ImageReader.OnImageAvailableListener() {
    @Override
    public void onImageAvailable(ImageReader reader) {
        Image image = null;
        try {
            image = reader.acquireLatestImage();
            if (image != null) {
                // 处理图像数据...
            }
        } finally {
            if (image != null) {
                image.close(); // 确保及时释放资源
            }
        }
    }
}, handler);

5.2.2 图像数据的处理方法和流程

处理图像数据时，通常会涉及到对图像缓冲区的操作。根据所使用的图像格式，处理方法也会有所不同。例如，对于YUV格式的图像，你可能会需要进行色彩转换，以便将其用于图像处理库或显示到屏幕上。

图像处理流程可能包括以下步骤： - 获取图像缓冲区的引用。 - 读取缓冲区中的图像数据。 - 根据需要转换图像数据的格式。 - 应用图像处理算法，例如图像增强或滤镜效果。 - 将处理后的图像数据用于显示或保存。

5.3 图像数据的存储与使用

5.3.1 图像数据的格式转换

捕获的图像数据通常需要转换为其他格式以适应不同的用途。例如，将YUV格式转换为RGB格式，以便于图像编辑或显示。转换过程中要注意效率和质量的平衡。

// 示例：YUV到RGB的转换过程（简化示例）
byte[] yuvData = ... // 假设从Image对象中获取到的YUV数据
int[] rgbData = new int[yuvData.length]; // 为转换后的RGB数据分配空间

// 转换算法的实现（这里省略具体实现细节）
// ...

// 此时rgbData数组中包含了转换后的RGB数据

5.3.2 将图像数据用于进一步处理或存储

捕获并处理后的图像数据可以用于多种用途，例如实时分析、对象识别、图像编辑或者直接保存到存储设备。在保存图像之前，通常还需要编码转换为JPEG或PNG格式：

Bitmap bitmap = ... // 假设从Image对象中创建的Bitmap对象
ByteArrayOutputStream stream = new ByteArrayOutputStream();
bitmap.compress(Bitmap.CompressFormat.PNG, 100, stream);
byte[] byteArray = stream.toByteArray();
File file = new File(getExternalFilesDir(null), "captured_image.png");
FileOutputStream fos = new FileOutputStream(file);
fos.write(byteArray);
fos.close();

以上章节的代码示例展示了ImageReader的基本使用方法和图像数据处理的初步步骤，为读者提供了一个从捕获到处理和存储图像数据的完整流程。在实际应用中，需要针对具体需求进行相应的优化和调整。

本文还有配套的精品资源，点击获取

简介：介绍了在Android 5.0及以上版本中使用Camera2 API进行相机预览和图像数据捕获的方法。从基础概念到预览设置，再到图像数据的获取和处理，详细阐述了Camera2 API的核心组件和功能，以及如何通过实战示例学习和应用这些技术。

本文还有配套的精品资源，点击获取