修正Android摄像头API

这几天本人参加了一个公司举办的编程马拉松,我打算使用Android摄像头来做。我一直都认为Android的API很糟糕,但是没有详细说出哪些地方糟糕,也没有说怎么改进会更好。趁这个机会,现在我就来解释解释。

我认为,Android关于摄像头的API非常糟糕,如果你没有用过,那么自己花点时间看看去吧。使用这个Camera API的 时候,经常会使开发者使用错误,会导致开发者忽略很多重要的东西,然后出问题了也很难发现,甚至在*上也很不乐观。换句话说,如 果有API需要你读完十个步骤(还有几个标记为“重要”的),那么,其实它是有问题的,怎么会写出这么麻烦的API呢?我们要改进它。

所以我打算重新构造它。我把重构后的代码放在GitHub上( EasyCamera),以下列出了我改的地方,还有修改的理由:

  1. 在使用startPreview()方法之前,需要先调用setPreviewDisplay(..)方法,然后再进行拍照的时候又需要调用它。为 什么不改进一下呢?如果不执行这个方法的话就会出问题,我们可以简单地抛出一个异常“Preview display not set”,但是这样终究不太好。所以,这个setPreviewDisplay(..)可以不要了,我们直接让startPreview(..)带上 surface作参数,然后还可以重载它让SurfaceTexture也作为参数传递进去。

  2. 在改进了预览设置后,现在开始改进预览操作。如果在拍照的时候,没有调用startPreview这个方法,那也会出问题,这里也可以简单抛出一个 异常“Preview not started”,但是要知道,这个异常是在运行时抛出的。所以,takePicture(..)这个方法也要改进,把它移到Camera这个类外面,放 到CameraAction类里。其它的需要在preview调用后才能使用的方法也需要这样改进(我暂时不知道有哪一些,当前的API里也没有列出 来)。接下来就是怎么获取一个CameraAction类实例了,很简单,直接调用startPreview(..)就可以返回一个 CameraAction了。

  3. 目前我们的改进只是让使用方法更加直观,然后减少出错的情况。不过takePicture这个方法好像有点奇怪,可以给它的参数全部传null值, 但是里面还有两个重写的方法需要这些参数。理论上说,传null值也可以,但是还有别的法子解决这个问题。其一就是介绍一个接口叫 PictureCallback,它有四个可以调用的方法,然后还提供一个默认的实现类,叫BasePictureCallback。当然,你会发现,在 这个场景中,好像也不太合适,因为这个例子中你传递这个callback接口的话,什么事都不会发生,但是传递null值的话,就不一样了(会出问题), 但是在我的手机上测试的时候,我传递一个shutter callback时,快门声音就会响,而传递null值就不会响。所以,这里主要介绍的就是使用这个callback接口,带有一个实现类,包含所有你需 要的所有方法。

  4. 到目前为止,改的还不错,还有就是,在照相完成后,需要restart preview,但是默认让它自动 restart也不是很好。目前的情况是,我们只有一个CameraAction类,然后调用startPreview(..)方法需要传递一个 surface参数,是不是需要引进一个restartPreview()方法呢?当然不用,这里我们让这个接口类的方法都返回一个布尔值,如果需要 restart preview,就可以返回true,这样会比较好,然后又有一个问题,如果这个callback类没有这4个方法调用呢,依赖这4个方法来得出是否需要 restart preview终究不好,所以,还需要在callback实现类中加一个restartPreview属性,只有在最后一个方法被调用时这个属性才会被设 置成true。

  5. 主要的步骤已经改进好了,还有其它的一些小问题需要改进,比如,关闭和打开camera的方法是不对称的,“open”和“release”配对感 觉不好,应该是“open”和“close”或者“acquire”和“release”。所以我觉得用“close”更好一些,况且(如果使用 java7),可以好好利用AutoClosable接口,还有try-with-resource结构(详情请查看java7新特性)。

  6. 在调用getParameter()方法的时候可以得到一份参数的副本,然后,你可能需要把更改过的这个副本设置回去,也是挺合理的。如果能提供一 个camera.setParameter(..)方法,可能使用起来会方便一些,不过Parameter类已经提供了很多方法了,所以在Camera类 里面添加不太好。或许这里可以设置可变参数?(当然现在也还没实现)

  7. 这个Camera的API糟糕的原因之一还有它的错误反馈,基本上可能得到一个报错信息“Came.takePicture failed”,无论什么原因导致的,通过以上的这些步骤,在某些情况下会过滤掉一些我们需要的异常信息,不过最好还是应该得到精确的报错信息。

  8. 我们的目的就是要让Camera使用更加友好(现在还不是),所以EasyCamera是一个容易使用的接口,CameraActions也是一个可造性很好的类。

本人的这个EasyCamera工程目前只是一个初版,也还没有用于实际生产环境中,但是我也希望得到大家的宝贵意见,争取把它做得更好,不断改进它。有的情况下,它也可以包含其它一些摄像头的功能,比如前后摄像头切换等等。

蹩脚的API会让开发者浪费大量的时间,金钱和精力,所以在设计API的时候,需要某些特殊的技能,还要多进行思考。Josh Bloch的关于API设计的见解很中肯,我强烈推荐它。事实上我也违反了其中一条-“if in doubt, leave it out”-通过CameraAction这个类我们可以完全掌控Camera,所以也有可能有很多操作是没用的,因为我对所有Camera的属性也不是很 了解,所以在代码里我也不会限制用户去做一些其它的操作。

一开始我写这篇文章的时候,其实我也没打算写EasyCamera这个东西,而事实上我是花了两个小时把它写出来了。最后,我建议所有开发者们,在 你遇到一些蹩脚的API时,可以像以上操作一样,自己动手做一些改造,多思考怎么设计和实现它们,然后你会发现这样比你慢慢修改和封住更省事,然后用起来 也就得心应手了。

修正Android摄像头API,布布扣,bubuko.com

修正Android摄像头API

上一篇:android JNI (二) 第一个 android工程


下一篇:iOS 网络数据之XML解析