RxCamera, 一个RxJava风格的android camera封装
事实上这个库写了已经有一段时间了,由于最近工作上比较忙,所以现在才写一篇文章来总结
What's this
正如标题所说, RxCamera 是一个基于RxJava而构建的一套 android.hardware.camera 封装的库。最初写这个库的目的是为了熟悉RxJava,并且而且也看到虽然在android开发已经有不少基于RxJava的库,但是关于音视频相关却少之又少,于是就动手实现了一下。目前这个库还处于非常早期的状态,API比较简陋,并且关于camera的设置还有很多没有做
How to use
在 RxCamera 的README中已经有关于这个库使用的比较详细介绍了,我在这里再说明一下:
加入依赖
首先你需要在项目中加入对RxCamera项目的依赖:
repositories { jcenter() } dependencies { compile 'com.ragnarok.rxcamera:lib:0.0.1' }
基本的使用
- 配置camera的参数
android的原生camera api提供了不少的选项来配置打开摄像头时候的参数,例如预览的帧率,预览的分辨率,自动对焦等,在RxCamera中主要是通过一个RxCameraConfig对象来管理这些对象,并通过RxCameraConfigChooser来配置对应参数:
RxCameraConfig config = RxCameraConfigChooser.obtain(). useBackCamera(). setAutoFocus(true). setPreferPreviewFrameRate(15, 30). setPreferPreviewSize(new Point(640, 480)). setHandleSurfaceEvent(true). get();
- 打开摄像头并获取数据
在设置好参数之后,就可以直接打开摄像头了:
RxCamera.open(this, config).flatMap(new Func1<RxCamera, Observable<RxCamera>>() { @Override public Observable<RxCamera> call(RxCamera rxCamera) { return rxCamera.bindTexture(textureView); // or bind a SurfaceView: // rxCamera.bindSurface(SurfaceView) } }).flatMap(new Func1<RxCamera, Observable<RxCamera>>() { @Override public Observable<RxCamera> call(RxCamera rxCamera) { return rxCamera.startPreview(); } });
这里包括了设置用于预览的Surface(这里是使用TextureView进行预览),然后正式开始预览。
只有预览之后才能开始获取摄像头的数据:
camera.request().periodicDataRequest(1000).subscribe(new Action1<RxCameraData>() { @Override public void call(RxCameraData rxCameraData) { showLog("periodic request, cameraData.length: " + rxCameraData.cameraData.length); } });
获取摄像头的数据都通过request来获取, RxCamera中封装了几种不同风格的cameraRequest,例如上面的是定时获取摄像头数据,每隔1000毫秒返回一次,另外还有连续返回数据,只返回一次数据等的request。这些request返回的Observable对象都会给订阅者返回RxCameraData对象,其中包含两个字段
byte[] cameraData Matrix rotateMatrix
目前的状态
很明显这个库目前还处于非常早期的状态,API还比较简单,并且很多摄像头的参数也没有加入到进行设置,例如白平衡,闪光灯,测光等,后续这里将会逐渐完善丰富摄像头的各种设置。另外,由于是完全基于RxJava来构建的库,大部分接口都会直接返回Observable对象,这对于没有熟悉RxJava的人来说可能还是会有点距离,因此这里后续对接口的封装还是需要继续改进,对外可能不再暴露Observable对象
About camera2
熟悉android开发的人估计都已经知道在Lollipop,Google新增一套 camera2 API用以取代之前的camera API,camera2提供了对摄像头更加精细化的控制,相对来说比起老的API,对摄像头的可控程度高了非常多。但我个人觉得新的API还不是特别好用,并且由于目前还是比较新,在使用新的camera2 API的时候, 还需要查询手机上有哪些特性是有实现的 ,目前使用起来相当麻烦。所以RxCamera暂时还不打算支持camera2.