Android原生相机开发指南：直接调用Camera API实现拍照功能
在Android应用开发中，实现相机功能是常见需求。除了调用系统相机应用外，开发者还可以直接使用Camera API访问设备摄像头硬件，实现自定义相机功能。本文将详细介绍如何在Android应用中通过Camera API实现拍照功能，这对开发专业相机类应用尤为重要。
Camera API概述
Camera类位于android.hardware包中，是Android系统提供的相机硬件接口类。它负责管理设备上的摄像头，提供预览、拍照、获取视频帧等功能。Camera类的大部分方法都是基于Native实现的，提供高效的硬件访问能力。
Camera类的主要方法包括：
- open()：打开默认摄像头，返回Camera实例
- open(int cameraId)：根据指定ID打开摄像头
- release()：释放Camera资源
- getNumberOfCameras()：获取设备支持的摄像头数量
- getParameters()：获取相机参数设置
- setParameters()：设置相机参数
- setDisplayOrientation()：设置预览方向
- setPreviewDisplay()：设置预览显示Surface
- startPreview()：开始预览
- stopPreview()：停止预览
- takePicture()：拍照
设备摄像头硬件检测
由于Android设备的多样性，使用Camera前应检测设备是否支持摄像头功能。可通过PackageManager的hasSystemFeature()方法实现：
/**
* 检查设备是否支持摄像头
* @param context 上下文对象
* @return 是否支持摄像头
*/
private boolean isCameraAvailable(Context context) {
PackageManager packageManager = context.getPackageManager();
return packageManager.hasSystemFeature(PackageManager.FEATURE_CAMERA);
}
相机预览实现
Camera预览需要通过SurfaceView显示。自定义一个CameraPreview类继承SurfaceView并实现SurfaceHolder.Callback接口：
public class CameraPreview extends SurfaceView implements SurfaceHolder.Callback {
private SurfaceHolder surfaceHolder;
private Camera cameraDevice;
private static final String TAG = "CameraPreview";
public CameraPreview(Context context, Camera camera) {
super(context);
cameraDevice = camera;
surfaceHolder = getHolder();
surfaceHolder.addCallback(this);
surfaceHolder.setType(SurfaceHolder.SURFACE_TYPE_PUSH_BUFFERS);
}
@Override
public void surfaceCreated(SurfaceHolder holder) {
try {
cameraDevice.setPreviewDisplay(holder);
cameraDevice.startPreview();
} catch (IOException e) {
Log.e(TAG, "预览初始化失败", e);
}
}
@Override
public void surfaceChanged(SurfaceHolder holder, int format, int width, int height) {
if (surfaceHolder.getSurface() == null) return;
try {
cameraDevice.stopPreview();
cameraDevice.setPreviewDisplay(surfaceHolder);
cameraDevice.startPreview();
} catch (Exception e) {
Log.e(TAG, "预览重启失败", e);
}
}
@Override
public void surfaceDestroyed(SurfaceHolder holder) {
// 清理工作在Activity的onDestroy中处理
}
}
拍照功能实现
实现拍照功能需要调用takePicture()方法，该方法支持多个回调参数：
/**
* 拍照回调处理
*/
private PictureCallback photoCallback = new PictureCallback() {
@Override
public void onPictureTaken(byte[] data, Camera camera) {
// 保存JPEG图片
savePhotoToStorage(data);
// 重新开始预览
camera.startPreview();
}
};
/**
* 执行拍照
*/
private void capturePhoto() {
// 先进行自动对焦
cameraDevice.autoFocus(new AutoFocusCallback() {
@Override
public void onAutoFocus(boolean success, Camera camera) {
if (success) {
// 对焦成功后拍照
camera.takePicture(null, null, photoCallback);
}
}
});
}
/**
* 保存照片到存储设备
* @param photoData 照片数据
*/
private void savePhotoToStorage(byte[] photoData) {
File outputDir = Environment.getExternalStorageDirectory();
String fileName = "IMG_" + System.currentTimeMillis() + ".jpg";
File outputFile = new File(outputDir, fileName);
try (FileOutputStream fos = new FileOutputStream(outputFile)) {
fos.write(photoData);
Log.i(TAG, "照片已保存: " + outputFile.getAbsolutePath());
} catch (IOException e) {
Log.e(TAG, "照片保存失败", e);
}
}
完整示例应用
布局文件 (activity_main.xml)
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical">
<FrameLayout
android:id="@+id/preview_container"
android:layout_width="match_parent"
android:layout_height="0dp"
android:layout_weight="1">
</FrameLayout>
<Button
android:id="@+id/capture_button"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_gravity="center"
android:text="拍摄照片"
android:layout_marginBottom="16dp"/>
</LinearLayout>
Activity实现 (MainActivity.java)
public class MainActivity extends AppCompatActivity {
private Camera cameraDevice;
private CameraPreview preview;
private FrameLayout previewContainer;
private Button captureButton;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
previewContainer = findViewById(R.id.preview_container);
captureButton = findViewById(R.id.capture_button);
// 初始化相机
initializeCamera();
// 设置拍照按钮点击事件
captureButton.setOnClickListener(v -> capturePhoto());
}
private void initializeCamera() {
if (isCameraAvailable(this)) {
try {
cameraDevice = Camera.open();
preview = new CameraPreview(this, cameraDevice);
previewContainer.addView(preview);
} catch (Exception e) {
Log.e("MainActivity", "相机初始化失败", e);
Toast.makeText(this, "无法访问相机", Toast.LENGTH_SHORT).show();
}
} else {
Toast.makeText(this, "设备不支持相机功能", Toast.LENGTH_SHORT).show();
}
}
@Override
protected void onDestroy() {
super.onDestroy();
if (cameraDevice != null) {
cameraDevice.stopPreview();
cameraDevice.release();
cameraDevice = null;
}
}
}
相机参数配置
Camera类提供了丰富的参数配置选项，可通过Camera.Parameters对象进行设置：
/**
* 配置相机参数
*/
private void configureCameraParameters() {
Camera.Parameters parameters = cameraDevice.getParameters();
// 设置图片尺寸
List<Camera.Size> sizes = parameters.getSupportedPictureSizes();
Camera.Size optimalSize = getOptimalPictureSize(sizes);
parameters.setPictureSize(optimalSize.width, optimalSize.height);
// 设置闪光灯模式
List<String> flashModes = parameters.getSupportedFlashModes();
if (flashModes != null) {
parameters.setFlashMode(Camera.Parameters.FLASH_MODE_AUTO);
}
// 设置对焦模式
List<String> focusModes = parameters.getSupportedFocusModes();
if (focusModes != null && focusModes.contains(Camera.Parameters.FOCUS_MODE_CONTINUOUS_PICTURE)) {
parameters.setFocusMode(Camera.Parameters.FOCUS_MODE_CONTINUOUS_PICTURE);
}
// 应用参数设置
cameraDevice.setParameters(parameters);
}
/**
* 获取最佳图片尺寸
*/
private Camera.Size getOptimalPictureSize(List<Camera.Size> sizes) {
// 实现根据屏幕尺寸选择最佳图片尺寸的逻辑
// 这里简化处理，返回第一个支持的尺寸
return sizes.get(0);
}
注意事项
- Camera对象使用后必须调用release()方法释放资源
- 预览必须在Surface创建后才能开始
- 参数设置必须在startPreview()之前完成
- 拍照后需要重新调用startPreview()恢复预览
- Android 6.0及以上版本需要动态申请相机权限
