CameraKit-Android

介绍：

一个基于谷歌CameraView library的相机处理程序，让安卓中最复杂的Camera api更简单。

运行效果：

使用说明：

基于 Google's CameraView library.

build.gradle:

compile 'com.flurgle:camerakit:0.9.12'

在布局中添加 CameraView ：

<com.flurgle.camerakit.CameraView
    android:id="@+id/camera"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:adjustViewBounds="true" />

确保重写了activity的onResume和onPause方法，并分别调用了 CameraView.start() 和 CameraView.stop()。

@Override
protected void onResume() {
    super.onResume();
    cameraView.start();
}
@Override
protected void onPause() {
    cameraView.stop();
    super.onPause();
}

捕获图片

调用CameraView.captureImage()捕获图片，设置CameraListener来处理图片的回调。

camera.setCameraListener(new CameraListener() {
    @Override
    public void onPictureTaken(byte\[\] picture) {
        super.onPictureTaken(picture);
        // Create a bitmap
        Bitmap result = BitmapFactory.decodeByteArray(picture, 0, picture.length);
    }
});
camera.captureImage();

捕获视频

捕获视频调用CameraView.startRecordingVideo()来开始，调用 CameraView.stopRecordingVideo() 来结束。设置一个CameraListener来处理视频回调。

camera.setCameraListener(new CameraListener() {
    @Override
    public void onVideoTaken(File video) {
        super.onVideoTaken(video);
        // The File parameter is an MP4 file.
    }
});
camera.startRecordingVideo();
camera.postDelayed(new Runnable() {
    @Override
    public void run() {
        camera.stopRecordingVideo();
    }
}, 2500);

其它属性

<com.flurgle.camerakit.CameraView xmlns:camerakit="http://schemas.android.com/apk/res-auto"
    android:id="@+id/camera"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    camerakit:ckFacing="back"
    camerakit:ckFlash="off"
    camerakit:ckFocus="continuous"
    camerakit:ckMethod="standard"
    camerakit:ckZoom="pinch"
    camerakit:ckCropOutput="true"  
    camerakit:ckJpegQuality="100"
    android:adjustViewBounds="true" />

Attribute	Values	Default Value
ckFacing	back front	back
ckFlash	off on auto	off
ckFocus	off continuous tap	continuous
ckMethod	standard still speed	standard
ckZoom	off pinch	off
ckCropOutput	true false	false
ckJpegQuality	0 <= n <= 100	100

ckFacing

back

cameraView.setFacing(CameraKit.Constants.FACING_BACK);

front

cameraView.setFacing(CameraKit.Constants.FACING_FRONT);

ckFlash（闪光灯）

off on auto

off

cameraView.setFlash(CameraKit.Constants.FLASH_OFF);

on

cameraView.setFlash(CameraKit.Constants.FLASH_ON);

auto

cameraView.setFlash(CameraKit.Constants.FLASH_AUTO);

ckFocus（对焦）

off continuous tap

off

cameraView.setFocus(CameraKit.Constants.FOCUS_OFF);

continuous

cameraView.setFocus(CameraKit.Constants.FOCUS_CONTINUOUS);

tap

cameraView.setFocus(CameraKit.Constants.FOCUS_TAP);

ckMethod

standard still speed

standard

cameraView.setMethod(CameraKit.Constants.METHOD_STANDARD);

当你使用 METHOD_STANDARD (camerakit:ckMethod="standard")的时候，图片捕获将使用普通camera API 的capture方法。

still

cameraView.setMethod(CameraKit.Constants.METHOD_STILL);

当使用METHOD_STILL (camerakit:ckMethod="still")的时候，图片将从preview中截取一帧。这种行为类似SnapChat 和 Instagram。这个方法具有更高的帧率的动态模糊，但是在低端相机上有更好的用户体验。

ckZoom

off pinch

off

cameraView.setZoom(CameraKit.Constants.ZOOM_OFF);

pinch

cameraView.setZoom(CameraKit.Constants.ZOOM_PINCH);

ckCropOutput

true false

true

cameraView.setCropOutput(true);

false

cameraView.setCropOutput(false);

ckJpegQuality

cameraView.setJpegQuality(100);

自动获权限

对于权限你自己想怎么处理就怎么处理，但是如果你在没有android.permission.CAMERA权限的情况下调用了CameraView.start()，将会抛出异常。

使用CameraKit，我们将自动在没有android.permission.CAMERA权限的时候弹出权限询问。如果你想自己处理，请确保获得了权限才调用 CameraView.start()。

动态尺寸

你可以任意设置CameraView的尺寸。当你的宽高比跟内部的 preview surface不一致的时候，surface将最小程度的裁减以填充这个view。这类似于ImageView上的android:scaleType="centerCrop"。

尺寸调整

你可以使用固定尺寸（固定值或者是match_parent），也可以使用 wrap_content。当你这样做的时候记得在CameraView上设置android:adjustViewBounds="true"。

如果设置为wrap_content，图像将自动和preview surface的比例对齐。此时整改预览区域都是可见的，没有剪裁。

事件

通过设置CameraListener来响应各种camera事件。

camera.setCameraListener(new CameraListener() {
    @Override
    public void onCameraOpened() {
        super.onCameraOpened();
    }
    @Override
    public void onCameraClosed() {
        super.onCameraClosed();
    }
    @Override
    public void onPictureTaken(byte\[\] picture) {
        super.onPictureTaken(picture);
    }
    @Override
    public void onVideoTaken(File video) {
        super.onVideoTaken(video);
    }
});