Android Camera1 使用指南：掌握原生相机功能

引言

Android 的原生 Camera1 API 提供了低级接口，让开发者可以对设备的相机硬件进行精细控制。尽管 Camera2 API 已成为更现代化的选择，但 Camera1 仍然广泛用于许多设备，并且提供了强大的自定义选项。本文将深入探讨 Camera1 API，指导开发者如何使用它来实现各种相机功能，例如预览、拍照、录制视频和获得原始视频帧。

预览

要开始使用 Camera1，首先需要打开相机设备。Camera1 API 通过 Camera 类提供对设备相机的访问。以下代码段演示了如何打开前置摄像头并开始预览：

Camera camera = Camera.open(Camera.CameraInfo.CAMERA_FACING_FRONT);
camera.startPreview();

Camera 类提供了多种方法来配置预览设置，例如预览大小、帧速率和预览格式。这些设置可以通过 Camera.Parameters 类进行修改。

拍照

要拍照，可以使用 Camera.takePicture() 方法。此方法将触发相机自动对焦并捕获图像。捕获的图像作为字节数组返回，可以将其保存到文件中或显示在界面上。

camera.takePicture(null, null, new PictureCallback() {
    @Override
    public void onPictureTaken(byte[] data, Camera camera) {
        // 保存图像或显示图像
    }
});

Camera.Parameters 类也提供了多种用于配置拍照设置的方法，例如图像大小、质量和闪光模式。

录制视频

Camera1 API 允许开发者录制视频。要开始录制，可以使用 Camera.startRecording() 方法。此方法将启动视频录制，并将录制的数据保存到指定的输出 URI 中。

camera.startRecording(outputUri, null);

Camera.Parameters 类同样提供了用于配置视频录制设置的方法，例如视频大小、比特率和视频编码器。

获取 NV21 视频帧

对于某些应用程序，可能需要获得原始视频帧的直接访问权限。Camera1 API 提供了 Camera.setPreviewCallback() 方法，允许开发者注册回调以接收每个新视频帧。

camera.setPreviewCallback(new PreviewCallback() {
    @Override
    public void onPreviewFrame(byte[] data, Camera camera) {
        // 处理 NV21 视频帧
    }
});

需要注意的是，NV21 格式是一种 YUV 格式，其中亮度 (Y) 数据与色度 (UV) 数据交织在一起。

相机参数设置

Camera1 API 允许开发者修改各种相机参数。这些参数包括对焦模式、曝光补偿、白平衡和场景模式。可以使用 Camera.Parameters 类来查询和设置这些参数。

Camera.Parameters parameters = camera.getParameters();
parameters.setFocusMode(Camera.Parameters.FOCUS_MODE_CONTINUOUS_PICTURE);
camera.setParameters(parameters);

结论

Camera1 API 为开发者提供了对 Android 设备相机硬件的低级控制。它允许开发人员自定义预览设置、拍照、录制视频和获得原始视频帧。虽然 Camera2 API 已成为更现代化的选择，但 Camera1 仍然广泛用于许多设备，并提供了强大的自定义选项。通过遵循本文中的指南，开发者可以充分利用 Camera1 API 的功能，创建具有自定义相机功能的强大应用程序。