Camera API笔记

说明

最近在学习音视频相关知识，把一些需要注意的点记录一下方便后续查阅，可能有些翻译不准确，如有错误欢迎指正，后面不再说明。以下内容都是摘自官方API文档。

正文

如果要访问设备的相机，首先要添加Manifest.permission.CAMERA权限，如果是6.0以上不要忘记权限申请，还有就是要包含清单元素声明在你的应用中使用的相机功能。例如，你使用了相机及自动对焦功能，你的清单文件应该包含下面几项：

<uses-permission android:name="android.permission.CAMERA" />
 <uses-feature android:name="android.hardware.camera" />
 <uses-feature android:name="android.hardware.camera.autofocus" />

使用相机类拍照的步骤如下

使用open(int)方法获取一个Camera实例
使用getParameters()方法获取现有（默认）的设置
如有必要，修改返回的 Camera.Parameters 对象并调用 setParameters(Camera.Parameters)方法
调用 setDisplayOrientation(int) 方法保证正确的预览方向
重要：给setPreviewDisplay(SurfaceHolder)方法传一个完全初始化的SurfaceHolder。没有surface，相机将不能开始预览。
重要：调用 startPreview() 方法开始更新预览显示。在你能够拍照之前必须要先开始预览。
当你想要通过调用 takePicture(Camera.ShutterCallback, Camera.PictureCallback, Camera.PictureCallback, Camera.PictureCallback) 方法来捕获一张照片时。等待回调返回真实的图像数据。
拍照后预览显示将停止，如果想拍更多的照片，请再次调用startPreview() 方法
调用 stopPreview() 停止更新预览显示
重要：调用 release() 方法释放相机以供其他应用使用。应用应该在Activity.onPause()方法立即释放相机（并在 Activity.onResume()方法重新创建).

快速切换到录像模式步骤如下

跟上面拍照步骤一样获取一个相机实例并开始预览
调用 unlock() 方法来允许媒体进程访问相机
将相机实例传递给MediaRecorder.setCamera(Camera)
录制完成后，调用 reconnect() 方法重新获取并锁定相机
如果需要，请重新开始预览拍摄更多的照片和视频
跟拍照描述的那样调用 stopPreview() 和 release()

Camera类非线程安全，适用于事件线程。大多数长时间运行的操作（如预览、对焦、拍照等）都是异步发生的，并在需要时调用回调。回调会在调用 open(int) 的事件线程中调用。一定不要同时在多个线程中调用Camera类的方法。

检查相机状态的一些方法

1检查相机固件

/** Check if this device has a camera */
private boolean checkCameraHardware(Context context) {
    if (context.getPackageManager().hasSystemFeature(PackageManager.FEATURE_CAMERA)){
        // this device has a camera
        return true;
    } else {
        // no camera on this device
        return false;
    }
}

2访问相机

要访问主摄像头，请使用Camera.open（）方法并确保捕获任何异常，如下面的代码所示：

/** A safe way to get an instance of the Camera object. */
public static Camera getCameraInstance(){
    Camera c = null;
    try {
        c = Camera.open(); // attempt to get a Camera instance
    } catch (Exception e){
        // Camera is not available (in use or does not exist)
    }
    return c; // returns null if camera is unavailable
}

警告：适用Camera.open()时请务必要检查异常。如果相机正在使用或不存在导致检查异常失败，系统将会关闭你的应用。
如果一个设备上有多个相机，上面的代码会访问第一个后摄像头。

3创建一个基本的相机预览类

/** A basic Camera preview class */
public class CameraPreview extends SurfaceView implements SurfaceHolder.Callback {
    private SurfaceHolder mHolder;
    private Camera mCamera;

    public CameraPreview(Context context, Camera camera) {
        super(context);
        mCamera = camera;

        // Install a SurfaceHolder.Callback so we get notified when the
        // underlying surface is created and destroyed.
        mHolder = getHolder();
        mHolder.addCallback(this);
        // deprecated setting, but required on Android versions prior to 3.0
        mHolder.setType(SurfaceHolder.SURFACE_TYPE_PUSH_BUFFERS);
    }

    public void surfaceCreated(SurfaceHolder holder) {
        // The Surface has been created, now tell the camera where to draw the preview.
        try {
            mCamera.setPreviewDisplay(holder);
            mCamera.startPreview();
        } catch (IOException e) {
            Log.d(TAG, "Error setting camera preview: " + e.getMessage());
        }
    }

    public void surfaceDestroyed(SurfaceHolder holder) {
        // empty. Take care of releasing the Camera preview in your activity.
    }

    public void surfaceChanged(SurfaceHolder holder, int format, int w, int h) {
        // If your preview can change or rotate, take care of those events here.
        // Make sure to stop the preview before resizing or reformatting it.

        if (mHolder.getSurface() == null){
          // preview surface does not exist
          return;
        }

        // stop preview before making changes
        try {
            mCamera.stopPreview();
        } catch (Exception e){
          // ignore: tried to stop a non-existent preview
        }

        // set preview size and make any resize, rotate or
        // reformatting changes here

        // start preview with new settings
        try {
            mCamera.setPreviewDisplay(mHolder);
            mCamera.startPreview();

        } catch (Exception e){
            Log.d(TAG, "Error starting camera preview: " + e.getMessage());
        }
    }
}

4拍照

如果想要实现一个JPEG格式的图片，你首先要实现Camera.PictureCallback接口用来接收图像数据并写入到文件，请看下面的示例：

private PictureCallback mPicture = new PictureCallback() {

    @Override
    public void onPictureTaken(byte[] data, Camera camera) {

        File pictureFile = getOutputMediaFile(MEDIA_TYPE_IMAGE);
        if (pictureFile == null){
            Log.d(TAG, "Error creating media file, check storage permissions");
            return;
        }

        try {
            FileOutputStream fos = new FileOutputStream(pictureFile);
            fos.write(data);
            fos.close();
        } catch (FileNotFoundException e) {
            Log.d(TAG, "File not found: " + e.getMessage());
        } catch (IOException e) {
            Log.d(TAG, "Error accessing file: " + e.getMessage());
        }
    }
};

下面是调用拍照的方法

// get an image from the camera
mCamera.takePicture(null, null, mPicture);

5MediaRecorder录制视频

使用MediaRecorder类录制视频时，必须要按照特定的顺序执行配置。下面的示例演示了怎么正确的配置并准备MediaRecorder类来录制视频：

private boolean prepareVideoRecorder(){

    mCamera = getCameraInstance();
    mMediaRecorder = new MediaRecorder();

    // Step 1: Unlock and set camera to MediaRecorder
    mCamera.unlock();
    mMediaRecorder.setCamera(mCamera);

    // Step 2: Set sources
    mMediaRecorder.setAudioSource(MediaRecorder.AudioSource.CAMCORDER);
    mMediaRecorder.setVideoSource(MediaRecorder.VideoSource.CAMERA);

    // Step 3: Set a CamcorderProfile (requires API Level 8 or higher)
    mMediaRecorder.setProfile(CamcorderProfile.get(CamcorderProfile.QUALITY_HIGH));

    // Step 4: Set output file
    mMediaRecorder.setOutputFile(getOutputMediaFile(MEDIA_TYPE_VIDEO).toString());

    // Step 5: Set the preview output
    mMediaRecorder.setPreviewDisplay(mPreview.getHolder().getSurface());

    // Step 6: Prepare configured MediaRecorder
    try {
        mMediaRecorder.prepare();
    } catch (IllegalStateException e) {
        Log.d(TAG, "IllegalStateException preparing MediaRecorder: " + e.getMessage());
        releaseMediaRecorder();
        return false;
    } catch (IOException e) {
        Log.d(TAG, "IOException preparing MediaRecorder: " + e.getMessage());
        releaseMediaRecorder();
        return false;
    }
    return true;
}

6使用相机功能

大部分相机功能可以通过 Camera.Parameters 对象激活并控制。你可以首先通过相机对象获得 Camper.Parameters 对象的实例，然后调用 getParameters() 方法，修改返回的参数对象并重新设置给相机对象。示例代码如下：

// get Camera parameters
Camera.Parameters params = mCamera.getParameters();
// set the focus mode
params.setFocusMode(Camera.Parameters.FOCUS_MODE_AUTO);
// set Camera parameters
mCamera.setParameters(params);

说明

正文