Android Camera之常用接口简介

时间:2024-04-08 10:34:06

Android Camera之常用接口简介

1.CameraInfo

用于描述camera的内部类,主要包括以下参数:

  • facing:代表相机的朝向,只能取CameraInfo中的两个静态值,源码说明如下:
	/**
         * The facing of the camera is opposite to that of the screen.
         */
        public static final int CAMERA_FACING_BACK = 0;//背对屏幕方向,后置相机

        /**
         * The facing of the camera is the same as that of the screen.
         */
        public static final int CAMERA_FACING_FRONT = 1;//和屏幕一个方向,前置相机

一般我们在使用相机初始化时,需要确定是开启前置还是后置相机。如果没有增加其他外置相机的条件下,后置和前置相机的ID分别为0和1,如果包含其他的外置相机,则相应的为2或其他值。为便于编程理解,一般直接使用以上两个值作为开启相机的ID。

mCamera = Camera.open(Camera.CameraInfo.CAMERA_FACING_BACK);//开启后置相机
  • orientation :表示相机采集图片的角度,该值是相机采集图片时需要顺时针旋转的角度,且旋转值固定为0、90、180、270中的一个。可以从源码说明中看出:
 /**
         * <p>The orientation of the camera image. The value is the angle that the
         * camera image needs to be rotated clockwise so it shows correctly on
         * the display in its natural orientation. It should be 0, 90, 180, or 270.</p>
         *
         * <p>For example, suppose a device has a naturally tall screen. The
         * back-facing camera sensor is mounted in landscape. You are looking at
         * the screen. If the top side of the camera sensor is aligned with the
         * right edge of the screen in natural orientation, the value should be
         * 90. If the top side of a front-facing camera sensor is aligned with
         * the right of the screen, the value should be 270.</p>

上一部分的翻译在上面的定义中已经说明,下面一段是针对该定义举例,翻译如下:

举例,假设设备处于自然竖直状态,后置相机的传感器是水平方向,你面对手机,如果传感器的顶部在手机屏幕的右边,那么这个值为90;如果前置摄像头的传感器顶部在手机右边,那么该值就是270。
  • setDisplayOrientation:该方法是用于设置相机的预览的方向,是对上文提及的Orientation的参数设置。在使用手机相机采用竖直预览时,该方法的就起到了很重要的作用,因为后置(前置)相机默认的预览方向是水平的,需要将其顺时针旋转90度,由下面的源码解释也可以看出。
Set the clockwise rotation of preview display in degrees. This affects
     * the preview frames and the picture displayed after snapshot. This method
     * is useful for portrait mode applications. Note that preview display of
     * front-facing cameras is flipped horizontally before the rotation, that
     * is, the image is reflected along the central vertical axis of the camera
     * sensor. So the users can see themselves as looking into a mirror.
    
    <p>This does not affect the order of byte array passed in {@link
     * PreviewCallback#onPreviewFrame}, JPEG pictures, or recorded videos. This
     * method is not allowed to be called during preview.
在相机预览时,通过设置该参数的顺时针的角度,来影响预览和拍照的图片效果,尤其在竖直使用相机时。但需要注意前置相机使用时,显示的效果会水平翻转,预览的效果如图照镜子。
注意,该参数的设置仅仅是影响预览的界面效果,不影响真实的相机采集的数据,因此在PreviewCallback和onPreviewFrame中获取的数据转为图像后,仍然呈现图像传感器方向的图片效果。在预览时,不可调用该参数。

提到上面的方向问题,需要结合安卓的坐标特点分析:

  • 屏幕坐标:安卓中的屏幕坐标是指左上角为圆点(0,0),以原点向屏幕的右延伸为X轴正方向,向下延伸为Y轴正方向。

  • 自然方向:自然方向是指安卓设备正常使用时的方向,比如手机是竖直的方向,平板是水平的方向。
    Android Camera之常用接口简介

  • 图像传感器方向:该方向是由手机的摄像机硬件传感器决定,该方向用于拍摄时的取景方向,上文提及的方向就是指图像的传感器方向。
    Android Camera之常用接口简介

  • 相机采集的方向:通过setDisplayOrientation()该方法仅仅是修改相机的预览方向,实际上并未改变获取的相机图像,在onPreviewFrame()中获取的数据转为图像后,显示的图像方向仍然与相机的图像传感器方向一致,可通过对获取的图片旋转,获取需要的图片,一般情况下,后置相机需顺时针旋转90度,前置相机顺时针旋转270度。
    小结:
    1.默认情况下手机的传感器方向是横向的,且是由传感器硬件决定,软件无法修改;
    2.通过setDisplayOrientation()可设置相机的预览方向,一般该值为顺时针90,修改后前置相机会出现水平镜像翻转;
    3.调用setDisplayOrientation()仅是改变预览方向,在onPreviewFrame()回调中获取的图像,一般后置相机需顺时针旋转90度,前置相机顺时针旋转270度。

2 .Parameters

该参数是用于对相机的参数的设置,使相机捕获的效果符合我们的要求,但是源码中的注解我们可以看出,对于该参的设置我们不能随意设置,因为不同的相机具体的性能,例如图片大小和闪光模式等。因此在设置该参数前,需要先查询一下相机支持参数,例如在设置setColorEffect(String)参数前,先调用getSupportedColorEffects(),查看支持参数,如果不支持该参数的设置,则反回为空。

默认情况下对于尺寸的获取和设置,其单位均是像素。一般在调用尺寸或格式的getXX时,默认会返回包含至少一组的有效元素集合。

Different devices may have different camera capabilities, such as
     * picture size or flash modes. The application should query the camera
     * capabilities before setting parameters. For example, the application
     * should call {@link Camera.Parameters#getSupportedColorEffects()} before
     * calling {@link Camera.Parameters#setColorEffect(String)}. If the
     * camera does not support color effects,
     * {@link Camera.Parameters#getSupportedColorEffects()} will return null.

一般在调用setXX前建议先调用对应的getXX方法,否则会显示如下异常:

java.lang.RuntimeException: setParameters failed
        at android.hardware.Camera.native_setParameters(Native Method)
  • 预览尺寸
    A: getSupportedPreviewSizes():返回相机支持的预览尺寸的集合。
    B:setPreviewSize(int width, int height): 设置相机的预览尺寸,注意该尺寸不是最终获取的图片尺寸。

  • 预览格式
    A: getSupportedPreviewFormats():获取相机支持的预览格式,包括ImageFormat.NV21、ImageFormat.NV16和ImageFormat.YV21等,默认情况下,所有相机均支持NV21格式。
    B: setPreviewFormat(int pixel_format):设置预览的数据格式

  • 采集图片尺寸
    A: getSupportedPictureSizes():获取相机支持的采集图像的尺寸。
    B: setPictureSize(int width, int height):设置采集图片的尺寸,该尺寸是指图片保存后的真实尺寸大小。

  • 采集图片格式

    A: getSupportedPictureFormats():设置相机支持的输出图片格式。
    B: setPictureFormat(int pixel_format):设置相机保存的图片格式。

  • 对焦模式

    A: getSupportedFocusModes():获取相机支持的对焦模式。
    setFocusMode(String value):设置相机的对焦模式。
    B: getMaxZoom():获取相机支持的最大焦距。
    C: setZoom(int zoom):设置焦距,该值的设置需要参照获取到的最大焦距值。

  • 最大检测人脸数
    A:getMaxNumDetectedFaces():返回当前相机支持的最大的人脸检测数,如果调用B:FaceDetectionListener后,该返回值始终为0,说明不支持该种检测类型。

小结:

在调用相机前需要根据需要对相机的参数进行设置,但是在设置时为避免设置的参数,该相机不支持,因此在设置前,建议调用对应的get方法,查看相机支持的对应参数。

3. Face

其实安卓系统从SDK 1.0开始就支持简单的人脸识别接口,在调用相机前,添加检测的监听(setFaceDetectionListener)在回调的onFaceDetection(Camera.Face[] faces, Camera camera)就可以获取Face信息,包括以下。

  • rect:检测到的人脸矩形的坐标参数(该坐标与相机坐标不同,需要转换后才可以使用)。

  • score:检测到人脸的可信度(范围1-100),取决于设备的不同,即使可信度值很低,也会将其回调出来,因此需要我们根据需求,过滤一下。

  • leftEye:左眼的坐标参数

  • rightEye:右眼的坐标参数

  • mouth:嘴的坐标参数

**注意:**并不是所有的相机都支持左眼、右眼和嘴的坐标参数回调,如果不支持则返回为null,并且该参数的坐标系与rect相同,因此需要我们手动转换为相机参数坐标系。

  • FaceDetectionListener:相机检测人脸的回到接口,并重写onFaceDetection(Face[] faces, Camera camera)方法,获取相机检测的人脸回调。

4. Camera类中的方法

  • 设备相机个数
    getNumberOfCameras():返回设备中支持的相机个数,默认为2(前后置相机),如果不支持或没有相机则返回0。

  • 开启相机

    A:open():使用后置相机创建相机对象,如果没有后置相机,则返回null。
    B: open(int cameraId):使用相机ID来创建相机对象,在同一时间,只能调用一个相机ID来创建相机对象,否则会报异常。获取的参数值为0至相机个数(getNumberOfCameras())减一。默认后置相机ID为0,前置为1。

  • 获取指定相机参数信息

    getCameraInfo(int cameraId, CameraInfo cameraInfo):返回指定相机的参数信息。

  • 预览

    A:方向 setDisplayOrientation(int degrees):设置相机的预览方向,前文已多次提及。

    B : 载体: setPreviewDisplay(SurfaceHolder holder):设置相机的预览载体,通过一个SurfaceHolder 实现实时预览的效果。

    C: 回调 setPreviewCallback(PreviewCallback cb):设置相机预览的回调监听,重写

onPreviewFrame(byte[] data, Camera camera)方法,获取每一帧的相机预览数据。

  • 开始
    startPreview():开始预览,在调用该方法前,必须先调用setPreviewDisplay()设置预览载体,否则没有效果。

  • 结束

    stopPreview():结束预览,在调用该参数前,建议先将setPreviewCallback和setPreviewDisplay设置为null。

  • 相机参数

    A:getParameters():获取当前相机的Parameters参数对象。
    B:setParameters(Parameters params):设置当前相机的参数对象。

  • 人脸检测

    A: startFaceDetection():开始人脸监听,在添加FaceDetectionListener前,需要先调用该参数。
    B stopFaceDetection():停止人脸检测监听。

  • 关闭相机

    release():释放相机资源。

小结:

以上方法中介绍了相机使用的关键方法,分类总结如下:

1.开启/关闭 :通过open()开启后置相机,或通过open(int cameraId)开启指定相机,在结束相机使用时,需要调用release()释放相机资源。

2.预览的设置:需要根据需要设置预览的方向,设置预览的载体,在开始预览前需要先设置载体,否则预览并未真正开始,结束预览后需要先将回调置为null然后调用release方法。

3.人脸检测:在添加FaceDetectionListener前,需要先调用startFaceDetection()方法,在检测结束时,调用stopFaceDetection()。

5.录像

相机录像的操作,主要通过MediaRecorder实现,通过对该类中参数的设置,实现相机录像的效果,下面主要讲解常用的接口,具体的实现在下面系列文章中会讲解,并附有github的Demo路径。

  • 设置相机
    setCamera(mCamera):设置指定的相机用于录制视频。

  • 音频源格式
    setAudioSource():定义的音频的物理资源和录制配置,该参数可查看AudioSource类,主要是包括各种对于麦克风优化后的各种参数设置。

  • 视频资源
    setVideoSource():设置视频资源,包括camera、surface两种,默认是采用来自camera。

  • 视频编码格式
    setVideoEncoder():设置视频的编码格式,包括默认、AAC(有损压缩)和AMR(压缩较大,质量较差)等

  • 视频帧率
    setVideoEncodingBitRate(): 在调用该参数前,先调用prepare()检测,以确保设置的帧率适用。

  • 分辨率
    setVideoSize():设置录制的分辨率,该参数的设置,必须放在设置编码和格式后面,否则报错。

  • 输出路径
    setOutputFile():设置存储录像的文件路径。

  • 最大录制时长
    setMaxDuration():设置最大的录制时间,单位为ms,也可不指定该参数。

  • 预览载体
    setPreviewDisplay():该参数的设置与相机预览类似,需要通过surface展示实时录像内容。

  • 准备预览
    prepare():调用该方法前,必须要设置音频、视频源、编码格式和帧率等参数,但必须在start()方法前。

  • 开始预览
    start():调用该方法时,必须拥有相机资源(锁定),如果调用该方法失败,需要重新获取相机资源。

  • 重置
    reset():调用该方法后,需要重置MediaRecorder的资源。

  • 结束
    stop():如果在start()后立即调用该方法,则会抛出Runtimeexception异常,原因时结束时未收到有效的音视频资源,导致清除导出目录下的文件资源。

  • 释放
    release():释放除了必要的MediaRecorder资源。

小结:
本部分主要讲解了关于视频录制(MediaRecorder)相关的接口,在录制视频前需要必须设置相机、音频格式、视频格式、帧率、分辨率和输出路径等,在调用prepare()前必须要设置好该参数。

6.总结

本文介绍了相机相关的接口参数,包括以下内容:

1.CameraInfo相关的角度、角度设置以及安卓的坐标;

2.Parameters相关的预览尺寸、格式、对焦模式和灯光等;

3.Face:相关的矩形框、人脸中眼睛和嘴的坐标等;

4.Camera类中相关的方法,包括相机参数、回调和人脸检测等;

5.录像中MediaRecorder类的主要参数的讲解等。

致谢:Android: Camera相机开发详解(上) —— 知识储备