RxCamera, 一个RxJava风格的android camera封装

jopen 8年前

事实上这个库写了已经有一段时间了,由于最近工作上比较忙,所以现在才写一篇文章来总结

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.