Android相机开发从入门到精通：Camera2 API实战指南

想要突破Android相机开发瓶颈？掌握Camera2 API将为你打开专业相机应用开发的大门。据统计，熟练运用Camera2可提升30%的开发效率，让你轻松实现从基础拍照到专业摄影的全功能覆盖。本文将通过"核心价值-技术解析-实战指南-进阶路径"的四象限结构，带你系统掌握Android相机开发的精髓。

核心价值：为什么选择Camera2 API？

现代Android应用对相机功能的需求已不再局限于简单拍照。从社交媒体的实时滤镜到专业摄影的手动控制，Camera2 API提供了前所未有的灵活性和控制力。相比传统API，它就像从傻瓜相机升级到单反相机，让你能够精确调整每一个参数，创造出专业级的相机体验。

学习价值：理解Camera2的核心优势，将帮助你在项目开发中做出更明智的技术选型，避免后期重构带来的额外成本。

技术解析：相机API的演进与对比

零基础也能懂的Android相机API演进史

Android相机API的发展经历了三个重要阶段，就像移动通信技术从2G到5G的演进：

• Camera1 (已废弃)：Android 1.0-4.4时代的"功能机"，简单易用但功能有限，就像早期的翻盖手机，只能满足基本拍照需求。

• Camera2 (当前主流)：Android 5.0+的"智能手机"，提供完整的相机控制能力，支持手动对焦、曝光调节等专业功能，如同现代智能手机的相机系统。

• CameraX (新兴选择)：Jetpack组件中的"相机应用"，封装了Camera2的复杂性，提供更简洁的API，适合快速开发，但定制化能力有所牺牲。

手把手实现Camera2架构解析

Camera2 API采用了基于管道的架构设计，主要包含以下核心组件：

• CameraManager：相机服务的入口，负责管理和查询设备上的相机资源
• CameraDevice：代表物理相机设备，用于创建相机会话
• CameraCaptureSession：管理预览和拍照请求，就像打电话时建立的通话连接
• CaptureRequest/CaptureResult：分别代表拍摄请求和结果，类似于发送消息和接收回复

图1: Camera2 API核心组件交互流程示意图，展示了从打开相机到完成拍照的完整过程

学习价值：掌握Camera2的架构设计，将帮助你理解相机应用的工作原理，为后续开发奠定理论基础。

实战指南：从零开始构建Camera2应用

环境准备与项目搭建

首先，我们需要准备开发环境并获取项目源码：

git clone https://gitcode.com/gh_mirrors/an/android-Camera2Basic

项目的核心代码位于kotlinApp/Application/src/main/java/com/example/android/camera2basic/目录下，主要包含以下关键文件：

• Camera2BasicFragment.kt：相机功能的主要实现
• AutoFitTextureView.kt：自适应预览视图
• ImageSaver.kt：图像保存处理

技术难点攻克：相机预览实现

问题：如何在应用中显示相机预览画面？

解决方案：使用TextureView作为预览容器，通过CameraCaptureSession实现预览功能：

// 简化代码片段，完整实现见Camera2BasicFragment.kt
private fun startPreview() {
    val surface = textureView.surface
    val previewRequestBuilder = cameraDevice.createCaptureRequest(CameraDevice.TEMPLATE_PREVIEW)
    previewRequestBuilder.addTarget(surface)
    
    cameraDevice.createCaptureSession(listOf(surface), object : CameraCaptureSession.StateCallback() {
        override fun onConfigured(session: CameraCaptureSession) {
            previewSession = session
            updatePreview()
        }
        
        override fun onConfigureFailed(session: CameraCaptureSession) {
            // 错误处理
        }
    }, null)
}

💡 小贴士：确保在创建CaptureSession前检查TextureView是否已准备就绪，否则可能导致预览黑屏。

技术难点攻克：拍照功能实现

问题：如何触发拍照并保存图片？

解决方案：创建拍照请求并设置ImageReader接收图像数据：

// 简化代码片段，完整实现见Camera2BasicFragment.kt
private fun takePicture() {
    val captureRequestBuilder = cameraDevice.createCaptureRequest(CameraDevice.TEMPLATE_STILL_CAPTURE)
    captureRequestBuilder.addTarget(imageReader.surface)
    
    // 设置自动对焦
    captureRequestBuilder.set(CaptureRequest.CONTROL_AF_MODE, 
        CaptureRequest.CONTROL_AF_MODE_CONTINUOUS_PICTURE)
    
    previewSession.stopRepeating()
    previewSession.capture(captureRequestBuilder.build(), captureCallback, null)
}

常见错误排查

🔍 权限问题：确保在AndroidManifest.xml中声明相机和存储权限，并在运行时请求权限：

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

📱 设备兼容性：不同设备的相机能力可能不同，使用CameraCharacteristics检查设备支持的功能：

val characteristics = cameraManager.getCameraCharacteristics(cameraId)
val capabilities = characteristics.get(CameraCharacteristics.REQUEST_AVAILABLE_CAPABILITIES)

💡 内存管理：及时释放相机资源，避免内存泄漏：

override fun onPause() {
    super.onPause()
    previewSession?.stopRepeating()
    previewSession?.abortCaptures()
    previewSession = null
    cameraDevice?.close()
    cameraDevice = null
}

图2: Camera2Basic应用运行界面，展示了相机预览和拍照按钮布局

学习价值：通过实际代码示例和常见问题解决方案，你将能够快速上手Camera2开发，避免常见陷阱。

进阶路径：从基础到专业的提升方案

掌握了Camera2Basic项目后，你可以通过以下扩展项目进一步提升技能：

1. 手动相机控制应用

实现手动曝光、对焦和白平衡调节，打造专业相机应用。关键是使用CaptureRequest设置手动参数：

// 手动对焦示例
captureRequestBuilder.set(CaptureRequest.CONTROL_AF_MODE, CaptureRequest.CONTROL_AF_MODE_OFF)
captureRequestBuilder.set(CaptureRequest.LENS_FOCUS_DISTANCE, focusDistance)

2. 实时滤镜相机

集成OpenCV或RenderScript实现实时滤镜效果。核心是在预览数据处理管道中添加滤镜算法：

// 简化的滤镜处理流程
imageReader.setOnImageAvailableListener({ reader ->
    val image = reader.acquireNextImage()
    // 应用滤镜处理
    val filteredImage = applyFilter(image)
    // 保存或显示处理后的图像
    saveImage(filteredImage)
    image.close()
}, null)

3. 视频录制功能

扩展项目支持视频录制，需要使用MediaRecorder类并配置适当的CaptureRequest：

// 视频录制初始化示例
mediaRecorder.setAudioSource(MediaRecorder.AudioSource.MIC)
mediaRecorder.setVideoSource(MediaRecorder.VideoSource.SURFACE)
// 配置视频格式、分辨率等参数
mediaRecorder.prepare()

学习价值：通过这些扩展项目，你将能够构建更复杂的相机应用，满足不同场景的需求，显著提升你的Android开发技能。

你可能遇到的3个问题

1. Q: 为什么我的相机预览画面是拉伸的？
   A: 这是因为预览尺寸与TextureView尺寸不匹配。参考AutoFitTextureView的实现，根据相机支持的预览尺寸调整视图比例。

2. Q: 拍照后图片保存失败怎么办？
   A: 检查存储权限是否已授予，确保应用有写入外部存储的权限。Android 10以上需要使用MediaStore API或申请MANAGE_EXTERNAL_STORAGE权限。

3. Q: 如何实现相机切换功能？
   A: 使用CameraManager枚举所有可用相机，通过cameraId区分前后摄像头，切换时重新创建CameraDevice和CaptureSession。

通过本文的学习，你已经掌握了Android Camera2 API的核心概念和实战技巧。从基础的相机预览到高级的手动控制，Camera2Basic项目为你提供了坚实的学习基础。现在，是时候动手实践，开发属于你自己的专业相机应用了！记住，最好的学习方式是在实际项目中应用这些知识，不断尝试和改进。